home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / README < prev    next >
Text File  |  1996-11-11  |  114KB  |  2,307 lines

  1.               DEVELOPER TOOLBOX, VERSION 6.1, SEPTEMBER, 1996
  2.  
  3.                              Table Of Contents
  4.  
  5.    * How to Get Started
  6.  
  7.    * Welcome
  8.         o DT v6.1 ==> IRIX 6.2
  9.         o site licensing
  10.         o multiple CDs
  11.  
  12.    * Version 6.1 New Additions
  13.  
  14.    * Also Included (pre-version 6.1 vintage)
  15.  
  16.    * CDROM/bin/helpfile
  17.         o if your CDROM drive is not mounted as /CDROM
  18.         o location of Developer Toolbox "help" documentation
  19.         o prerequisites to satisfy before starting any viewing
  20.             A. For people running viewDT on an IRIX 6.2 system
  21.                  i. Make sure you have all the Netscape(TM) helper programs
  22.                     installed
  23.             B. For people running viewDT on an IRIX 5.3 (i.e. a non IRIX
  24.                6.2) system
  25.                  i. Make sure you have all the Netscape helper programs
  26.                     installed
  27.                 ii. Make sure you have all the appropriate patches installed
  28.                iii. Possible Inst Warning Messages and Conflicts
  29.                 iv. A PostScript Viewing Issue
  30.         o how to do the viewing
  31.         o essential information about the viewing process
  32.         o files placed on your workstation while running viewDT
  33.  
  34.    * How to use the Developer Toolbox Distributed CDROM Resource Manager
  35.         o To EJECT Your Currently Loaded CD
  36.         o dtCDmgr orientation
  37.         o Important Files
  38.         o User Interface
  39.              + Using the Display Region
  40.              + Using the Buttons
  41.              + Using the Pull-Down Menus
  42.         o Troubleshooting
  43.  
  44.    * janitors's corner
  45.  
  46.    * Credits
  47.  
  48.                              How to Get Started
  49.                        -------------------------------
  50.       To use these CDs to their fullest, you need to run IRIX 6.2(TM)
  51.  
  52. Remember the living MASTER WEB HOUSE exists at https://www.sgi.com/toolbox/
  53.  
  54.      NOTE: Please be aware there are three versions of this file. The
  55.      printed liner notes are cast in concrete first, then the CD
  56.      version, <CDROM>/toolbox/linerNotes.html, gets snapped. The web
  57.      house version, https://www.sgi.com/toolbox/linerNotes.html, is
  58.      never frozen, and is always the definitive source for these notes.
  59.      It is a virtual certainty that these hardcopy notes will not
  60.      contain ALL the information and details that will exist in both of
  61.      the other two sources listed above. Please refer to them where and
  62.      when possible.
  63.  
  64.                -- For People With Less Than 3 CDROM Drives --
  65.       Please read about invoking viewDT, and understand how to ensure
  66.     correct content downloading from the DT v6.1 CD Pitfalls explantion.
  67.  
  68. Step 0 - Select a CD
  69.  
  70.      If you know you do not have perl installed on your system, then select
  71.      Developer Toolbox CD1. If you don't know about perl, don't worry, you
  72.      will be guided through installation if it proves necessary.
  73.  
  74.      Otherwise if you know information you desire is on a particular CD,
  75.      then choose that CD.
  76.  
  77.      Otherwise, it is a good time to be random.
  78.  
  79. Step 1 - Run the CD
  80.  
  81.      We presume you have your CDROM drive mounted under /CDROM. For those
  82.      with a different mount point, substitute that directory name for the
  83.      places we mention /CDROM. See Section 0 of the /CDROM/bin/helpfile,
  84.      below for more info.
  85.  
  86.      Run the command,
  87.           /CDROM/bin/viewDT
  88.      This will copy approximately 10 MB worth of DT software to local disk
  89.      the first time it is invoked. It will then start the DT viewing process
  90.      using the DT software.
  91.  
  92.      You have now begun to explore the contents of the v6.1 DT Set.
  93.  
  94.      Actually, the full command comprises the following forms:
  95.  
  96.       /CDROM/bin/viewDT [-r] [-f </directory>]
  97.       /CDROM/bin/viewDT [-r] [-f tmp_dir] [-C CD_dir]
  98.       /CDROM/bin/viewDT -u [-f tmp_dir]
  99.       /CDROM/bin/viewDT -R [-f tmp_dir]
  100.       /CDROM/bin/viewDT -h
  101.  
  102.         -h          Help text (this stuff)
  103.         -r          Remove DT_utilities directory when viewDT finishes
  104.         -R          Just remove DT_utilities directory
  105.         -u          Just create DT_utilities directory
  106.         -f tmp_dir  Possible directory to hold DT_utilities
  107.         -C CD_dir   Directory of CD to be viewed
  108.  
  109.      but you will only want these other command line options if you have
  110.      special circumstances. It is necessary to copy approximately 10
  111.      megabytes onto your local disk in order for the viewDT script to
  112.      function. Running the above command without any arguments will copy a
  113.      set of files into your /usr/tmp directory where they will remain even
  114.      after viewDt exits. They are ready for future viewDT sessions.
  115.         o If you add the -r flag, viewDT will remove the 10 MBs worth of
  116.           files when you exit viewDT.
  117.         o With the -f </directory> option, you can explicitly specify to
  118.           where you want the 10 MB to be copied.
  119.      For more details about all this, see, Section 3, how to do the viewing
  120.      from the copy of the /CDROM/bin/helpfile, at the back of these notes.
  121.  
  122.  
  123.  
  124.                    welcome to the            version 6.1
  125.  
  126.                                September, 1996
  127.  
  128.                On-line version of v6.1 CD Set Liner Notes
  129.  
  130. THE TOOLBOX JANITOR extends sincerest greetings to all, and hopes the
  131. organization and presentation of information herein provides an essential
  132. and ever-increasingly effective resource.
  133.  
  134.         The Developer Toolbox is a publication produced for all
  135.      registered Silicon Graphics« software and hardware developers by
  136.      the Silicon Graphics Developer Program. The raison d'Ωtre of the
  137.      Toolbox is to serve as an information resource, providing an
  138.      ever-expanding library of learn-by-example materials, as well as a
  139.      wide range of technical information, for people endeavoring to
  140.      create applications to operate on Silicon Graphics systems. The
  141.      formal mission statement of the Toolbox is
  142.  
  143.           To provide members of the developer program with
  144.           detailed technical information on a timely basis. The
  145.           toolbox includes proprietary, unpublished, and published
  146.           materials from a wide variety of SGI sources presented
  147.           in a one-stop-shop framework. This information
  148.           fundamentally includes learn-by-example and actual
  149.           application source code, as well as proprietary and
  150.           published documentation, software in inst image format,
  151.           and useful utilities.
  152.  
  153.         The Toolbox contains Silicon Graphics source code (plus
  154.      compiled executables), technical documentation (unreleased as well
  155.      as released), public domain source code (ported to the IRIS«),
  156.      data file sets (audio, inventor, image, geometry), web-related
  157.      information (HTML, http, cgi-scripts), and utilities (where source
  158.      isn't available) plus inst software, for the purpose of helping
  159.      developers learn about, and implement code for, IRIS workstations.
  160.      This software and information is intended for use by both
  161.      beginning and advanced IRIS programmers. The philosophy driving
  162.      the ongoing creation and production of the Toolbox is to provide
  163.      our developer community with as much leading/bleeding edge
  164.      software, hardware information, documentation, FAQ lists, binary
  165.      tools and utilities not available to the general Silicon Graphics
  166.      customer base so they are as "up-to-the-minute" as possible in
  167.      understanding where Silicon Graphics is going.
  168.  
  169.                             DT v6.1 ==> IRIX 6.2
  170.                             --------------------
  171.  
  172.         Except for the binaries in each CD's /CDROM/bin directory --
  173.      which provide the "web-accessibility" to the DT via the viewDT
  174.      script and the Netscape Navigator Client, 2.02S software (which is
  175.      IRIX 5.3-based) -- v6.1 of the Developer Toolbox is entirely built
  176.      upon IRIX 6.2. These binaries -- the compiled programs in the
  177.      bin/, documents/video/lurker/ij/, hardware/{dat.kernel/,
  178.      mount_media/{cdmount/, mountMO/}, parallel_port/, summa/test/},
  179.      public/TIFF/tools/, src/, and utilities/CDmastering/
  180.      sub-trees/directories -- will not run correctly on prior versions
  181.      of IRIX. For those of you still on IRIX 5.3, most of the program's
  182.      source code has not changed (see
  183.      /toolbox/DTinfo/DT6.2port.html#CHNGED for a list of what source
  184.      code/Makefiles did change) so you can copy same onto to your local
  185.      disk in order to re-compile an IRIX 5.3 version. Further, the 6.0
  186.      DT Web-on-CD has a complete 5.3 version of all this source aside
  187.      from any added new stuff.
  188.  
  189.         v6.1's biggest claim to fame is that it is the first toolbox to
  190.      move up to the world of IRIX 6.2. The toolbox source, build, test
  191.      and SGI-internal-website machine, named dtdustbin and aliased as
  192.      "swank", is an IP19 6-processor Challenge-L system. In May, we
  193.      upgraded swank to IRIX 6.2, changing the 2GB system disk to be an
  194.      xfs filesystem in the process. After the Developer Forum we began
  195.      the process of re-compiling all source code on the DT with the
  196.      "bare-bones", "just compile-and-run on a 64-bit system without
  197.      reaping any of its new benefits" O32 (-mips2 -o32) default IRIX
  198.      6.2 compiler settings defined in /usr/include/make/releasedefs. In
  199.      qualifying what we mean here by the slippery-to-some-people
  200.      "64-bit system" term, it is useful to quote from that
  201.      grand-vizier-at-large Dave "Guru and busybody at large" Olson,
  202.      when he clarified this point in the sgi.engr.devp internal
  203.      newsgroup,
  204.  
  205.           The problem is how you define 64 bit. Some people still
  206.           want to assume that 64 bit means 64 bit addressing. 64
  207.           bit can also be interpreted to mean 64 bit busses or i/o
  208.           paths, and we've had that on all of our r4k and later
  209.           systems. It can also be interpreted to mean 64 bit
  210.           integer operations, loads, stores, etc., and we have
  211.           that on all systems in 6.2 with N32. It can also be
  212.           interpreted to be large files and filesystems, and we
  213.           have that (although not quite as large on the 32 bit OS
  214.           desktop machines; they are large enough.)
  215.              The only thing that is not 64 bit about the desktop
  216.           r4k systems in 6.2 is the address space. I'm not saying
  217.           that this is unimportant, but it IS only one
  218.           portion/definition of being 64 bit, and it's important
  219.           that everybody understand the distinction, particularly
  220.           if you are working with developers. It's also important
  221.           that you understand how and why we are positioning 6.2
  222.           as 64 bit on all platforms. And no, I'm not a pod. I
  223.           believe you can be 64 bit, without having 64 bit
  224.           addressing, for the vast majority of apps.
  225.  
  226.      See What We Did to Port the Developer Toolbox to IRIX 6.2 for all
  227.      the details about what we did and learned about in order to
  228.      recompile the DT src on IRIX 6.2.
  229.  
  230.         In re-compiling the DT binaries on IRIX 6.2, we are increasing
  231.      our emphasis to you, our developers, of the importance of porting
  232.      your applications and environments to an IRIX 6.2, all R4000 and
  233.      higher platforms' universe, since this will be the native
  234.      Operating System for all upcoming Silicon Graphics products. Such
  235.      systems won't know a thing about the "IRIX 5 dimension". Hence,
  236.      the sooner your programs can compile on IRIX 6.2 -- even with just
  237.      the "bare-bones" O32 option -- the sooner you'll be able to take
  238.      advantage of the "next generation" of SGI machines debuting later
  239.      this year. The other central fact about this situation is that ELF
  240.      binaries compiled on IRIX 5.3 will run correctly on IRIX 6.2. But
  241.      the best strategy is to qualify existing 5.3 based binaries on 6.2
  242.      to support existing platforms and begin the effort to move forward
  243.      with SGI in the near-term future.
  244.  
  245.         In all our efforts to complete a sufficient "baseline" to ship
  246.      in v6.1, we were unsuccessful in re-compiling anything as N32 --
  247.      we did do an entire pass of the tree using make -i, but a
  248.      significant number of "Warning" messages using O32 turned into
  249.      "Fatal Error" messages with N32. This is the work before ALL of
  250.      us. For our part, this fall we will create an "N32 Progress" page
  251.      in which we include links to those programs which are
  252.      "N32-compliant" as we are able to clean up current DT source, as
  253.      well as add in new N32-created programs. Another component of this
  254.      "N32 transition puzzle" that will help all of us is the mongoose
  255.      MIPS PRO 7.0 compiler, since it compiles faster, and in less
  256.      memory, than the ragnarok compilers that shipped with IRIX
  257.      6.0.1-6.2.
  258.  
  259.                                site licensing
  260.                             --------------------
  261.  
  262.         Many of you would like to be able to serve the contents of the
  263.      Developer Toolbox from your local website. Here is what is
  264.      required.
  265.  
  266.        1. Security and Your Liability
  267.           The information contained in the Developer Toolbox can only
  268.           be used by current members of the Developer Program. This
  269.           means it can only be made available to employees of your
  270.           company. For instance, it is a violation to place the
  271.           contents of the Developer Toolbox on your local web connected
  272.           to the Internet, without an appropriate firewall or a secure
  273.           server. Be sure you are well-versed on the Developer Toolbox
  274.           Terms and Conditions of Use and Disclaimer, i.e. failure to
  275.           adhere to these Terms and Conditions could result in
  276.           financial liability for you and/or your company.
  277.  
  278.        2. The Absolutely Easiest Way to "Pseudo-Serve" the DT
  279.           Suppose you have 3 CDROM drives available on one or more
  280.           systems on your local area network. And further, suppose
  281.           these 3 CDROM are dedicated to serving the Developer Toolbox
  282.           CDs. Then, all you have to do is place one CD in each CDROM
  283.           drive and make sure they are exported (so they can be seen by
  284.           any other system). From any machine with automount running
  285.           you could run: /hosts/sgi_dt/CDROM/bin/viewDT to start
  286.           viewing the Toolbox where one of its CDs is loaded on the
  287.           CDROM drive connected to the machine named "sgi_dt". You
  288.           supply the paths to other CDs when dtCDmgr asks for them. As
  289.           long as the CDs stay put in their respective CDROM drives,
  290.           you would only need to do this once as dtCDmgr remembers
  291.           where to look for the CDs that have already been specified in
  292.           a previous session.
  293.  
  294.        3. An Easy Way to "Pseudo-Serve" the DT
  295.           Just copy each CD to a separate directory on disk.
  296.  
  297.           For example, let's suppose you are using the sgi_dt machine
  298.           as the server, that it has automount running, and that you
  299.           have copied the CDs to sgi_dt:/dt_6.1/cd0, sgi_dt:/dt_6.1/cd1
  300.           and sgi_dt:/dt_6.1/cd2. From any machine with automount
  301.           running you could run: /hosts/sgi_dt/dt_6.1/cd0/bin/viewDT to
  302.           start viewing the Toolbox. You supply the paths to other CDs
  303.           when dtCDmgr asks for them. As long as the CDs stay put in
  304.           their respective CDROM drives, you would only need to do this
  305.           once as dtCDmgr remembers where to look for the CDs that have
  306.           already been specified in a previous session.
  307.  
  308.        4. Serving the DT on your web
  309.           This is a more complicated process involving the running of
  310.           the oksvr server search engine along with necessary cgi-bin
  311.           scripts from /toolbox/www/cgi-bin. To do this correctly will
  312.           require work on both your and our part since each website
  313.           will have unique site-specific details to decide upon and
  314.           configure. We have opted not to tackle this route in the v6.1
  315.           release. The possibility exists that we will succeed in
  316.           creating the "how to" process write-up to document
  317.           implementing this before the v6.2 DT Web-on-CD release at
  318.           year's end. Stay tuned to the Toolbox web site's NEW page for
  319.           updates regarding this.
  320.  
  321.           The possible downside of the previous two methods is that
  322.           separate HTTPD and oksvr servers are created with each
  323.           viewing of the toolbox. It would be cleaner to just have a
  324.           single version of each server (as we do with our main
  325.           website, https://www.sgi.com/toolbox/).
  326.  
  327.                                 multiple CDs
  328.                             --------------------
  329.  
  330.         The /CDROM/bin/viewDT DT-viewing mechanism, along with its
  331.      cohort the dtCDmgr program, have both experienced a great deal of
  332.      "maturing" since v6.0 to provide a more seamless access mechanism
  333.      for sifting the contents of the DT. We greatly appreciate the
  334.      support of those developers who helped us nail down the problems
  335.      some of you experienced with the vagaries of v6.0's viewDT script.
  336.  
  337.         If you have more than one CDROM drive accessible by your
  338.      machine on your Local Area Network, you can put these CDs into the
  339.      available drives, and inform viewDt, specifically dtCDmgr, of all
  340.      of their locations when it prompts you for a particular needed CD.
  341.      You will then be able to explore all the contents as if you had
  342.      this DT nfs-mounted on disks from other machines. If you only have
  343.      one CDROM drive, the dtCDmgr will prompt you to switch CDs
  344.      whenever you access a link pointing to a file on a CD other than
  345.      the one currently loaded. (See the v6.1 contents of the
  346.      /CDROM/bin/helpfile file included in the back of these liner notes
  347.      for details about the operation of all this.)
  348.  
  349.         For those of you who have already received v6.0 and it's
  350.      binder, we've designed v6.1 to be inserted into it following the
  351.      v6.0 release. For the artwork and production of v6.1 we are deeply
  352.      grateful to artist Tim Racer (our on-going "hired gun" visual
  353.      wizard who painted the binder's cover as well as the v6.0 divider)
  354.      and the steadfast help, creativity, and resourcefulness of Sophie
  355.      Lonsky, Amy Gregg, and Jenifer Bailey. embarkation of ratmandu and
  356.      whitewolf
  357.  
  358.  
  359.  
  360.  HUB | Pheedbak | Tree | Topic | A-Z | Search | Hot | New | FAQs | Jumpdoors
  361.  
  362. ----------------------------------------------------------------------------
  363.  
  364.      For all issues relative to the CONTENT of the Toolbox, pleeze contact:
  365.         o dave "information ferret" ratcliffe: dave@sgi.com, 415/933-3556,
  366.           fax: 415/967-6239
  367.         o Tom "the mechanic" Murphy: murphy@sgi.com, 415/933-9134, fax:
  368.           415/967-6239
  369.         o or, DTjanitor@sgi.com which sends mail to both of us
  370.           simultaneously.
  371.  
  372.      For ALL OTHER ISSUES relative to the Toolbox, pleeze contact:
  373.         o devprogram@sgi.com, 415/933-3033, 1-800/770-3033, fax:
  374.           415/969-6327.
  375.  
  376.  
  377.  
  378.                          VERSION 6.1 NEW ADDITIONS:
  379.  
  380.      DOCUMENTATION:
  381.  
  382.         * C++:
  383.              o Introduction to RogueWave Tools.h++ Libraries for Irix
  384.                6.2
  385.  
  386.         * Developer News Articles:
  387.              o May/June 1996:
  388.                   + The Next Generation of Compiler Technology
  389.                   + Accessing 64-bit CPU Power with 32-bit Software
  390.                   + Analyzing Java Programs with Cosmo Code
  391.                   + IRIX 6.2 and the MIPS ABI
  392.                   + FORTRAN Dynamic Threads and System Throughput
  393.              o March/April 1996:
  394.                   + IRIX 6.2 Update
  395.                   + What is a MIPS ABI Process Port?
  396.                   + Announcing the Release of Hot Mix 13
  397.                   + Silicon Graphics Launches WebFORCE Intranet
  398.                   + 1996 Trade Show and Events Calendar
  399.              o January/February 1996:
  400.                   + Exploring the Updated Hardware Interfaces of the
  401.                     Audio/Serial Option and IMPACT Graphics
  402.                   + Adding Session Management to Your Application
  403.                   + Attention OpenGL, Performer, and Open Inventor
  404.                     Developers
  405.                   + Obtaining Technical Support for Your Silicon
  406.                     Graphics Products
  407.                   + efscopy: No Ordinary Copy Utility
  408.  
  409.         * IRIX 5.3:
  410.              o updated Documentation Catalog for IRIX 5.3, July 3, 1996
  411.  
  412.         * IRIX 6.2:
  413.              o What We Did to Port the Developer Toolbox to IRIX 6.2
  414.              o Preparing for IRIX 6.2 & 64-bit, A Nutshell view and
  415.                series of pointers
  416.              o IRIX 6.2 for System and Network Administrators,
  417.                Pipeline, May/June, 1996
  418.              o IRIX 6.2 Instructions for Customers Updating From
  419.                Earlier IRIX Releases
  420.              o IRIX 6.2 Datasheet, June 18, 1996
  421.              o IRIX 6.2 Technical Specifications, January 10, 1996
  422.              o updated Documentation Catalog for IRIX 6.2, July 3, 1996
  423.  
  424.         * OpenGL:
  425.              o OpenGL Character Renderer: A Specification, Version 0.2,
  426.                26 Dec 1995
  427.              o enhanced OpenGL: FROM THE EXTENSIONS TO THE SOLUTIONS:
  428.                various corrections, a set of complete class slides for
  429.                printing, Search capability, links to other OpenGL web
  430.                sites, and updated Man pages
  431.              o OpenGL Render Serving "Frequently Asked Questions"
  432.              o Column 9: EXIT: A 3D standard for X (finally!),
  433.                March/April, 1996
  434.              o HTML version of X Server Multi-rendering for OpenGL and
  435.                PEX
  436.  
  437.         * PCI:
  438.              o PCI Developer Guide
  439.              o PCI Device Drivers
  440.              o PCI FAQ
  441.              o PCI Developer Lab
  442.              o Preparing for the PCI Bus on Silicon Graphics Systems
  443.  
  444.         * public:
  445.              o SGI Anonymous FTP Sites, updated to August 6, 1996
  446.  
  447.         * Toolbox:
  448.              o What We Did to Port the Developer Toolbox to IRIX 6.2
  449.              o our current DT TODO 18-month-out schedule
  450.              o The janitors' Vision of Collaboration between you and
  451.                us.
  452.              o description of The Remaining Coff Files on the DT and
  453.                our plans to replace them.
  454.  
  455.         * Video:
  456.              o The Lurker's Guide to Video, a repository for the
  457.                little-known, undocumented knowledge that you need in
  458.                order to write any sort of video app on SGI machines.
  459.                Topics explored in great detail include Video in
  460.                General, The VL, SGI Video Devices.
  461.  
  462.         * X:
  463.              o D11: A High-Performance, Protocol-Optional,
  464.                Transport-Optional Window System with X11 Compatibility
  465.                and Semantics, February, 5 1995
  466.              o HTML version of Programming X Overlay Windows
  467.  
  468.         * WWW:
  469.              o Grant Gouldon's Web Authoring Notes, some helpful
  470.                jumpdoors for web authoring.
  471.  
  472.      SRC:
  473.  
  474.         * CDio, software for Writing and Reading CDs enables one to
  475.           make an SGI efs OR ISO or Audio CD
  476.  
  477.         * stereotest, demos OpenGL stereo-in-a-window with a model that
  478.           can be interactively manipulated and moved
  479.  
  480.         * Choosing an Input Jack src code example, from The Lurker's
  481.           Guide to Video, information gold mine of what you need to
  482.           know about video.
  483.  
  484.         * enhanced OpenGL: FROM THE EXTENSIONS TO THE SOLUTIONS:
  485.           various corrections, 6.2-built binaries
  486.  
  487.         * Customer Education's opengl1 & opengl2 class source, both
  488.           sets of which are revamped to use GLUT; opengl2's preferred
  489.           platforms are Impact, RealityEngine or InfiniteReality and
  490.           some of the new SGI_extensions must be compiled on IRIX 6.2
  491.           else they won't be used.
  492.  
  493.         * fontflip, demonstrates some of the capabilities of the OpenGL
  494.           Character Renderer, a.k.a. the GLC library.
  495.  
  496.         * gmemusage now includes the 6.2-based src; the binary is
  497.           shipped in eoe.sw.perf.
  498.  
  499.         * GLUT, release 3.1, May 3, 1996
  500.  
  501.         * cmapdoctor extended so that
  502.             1. list widget displays colormaps sorted by X colormap
  503.                handle
  504.             2. display now shows the number of colors in the visual
  505.  
  506.      BINARIES:
  507.  
  508.         * public:
  509.              o rebuilt version of Xemacs binary to be overlaid on
  510.                freeware2.0 installed version
  511.  
  512.         * utilities:
  513.              o a 5.3-built version of the 6.2 utility, showfiles
  514.                enables people on pre-6.2 systems to extract src and/or
  515.                man images of 6.2-built inst images like those in
  516.                freeware 2.0.
  517.  
  518.      INST IMAGES:
  519.  
  520.         * IRIX 5.3 and 6.2 versions of
  521.              o Netscape Navigator Client, 2.02S, August 6, 1996
  522.              o Netscape Navigator Client, 3.0, September 24, 1996
  523.  
  524.         * IRIX 5.3 patches:
  525.              o Patch 1412 - IRIX 5.3 Networking Rollup Patch, August
  526.                13, 1996
  527.              o Patch 1268 - 5.3/5.3xfs combined kernel rollup patch,
  528.                June 6, 1996
  529.              o Patch 1264 - XFS rollup patch for 5.3, May 1, 1996
  530.              o 5.3 X server roll up:
  531.                   + Patch 1271 - for Impact systems, May 1, 1996
  532.                   + Patch 1187 - for non-Impact systems, March 22, 1996
  533.              o Patch 1102 - IRIX 5.3 NFS roll up, April 3, 1996
  534.              o Patch 1095 - IRIX 5.3 Scrolled Window patch, January 19,
  535.                1996
  536.  
  537.  
  538.  
  539.                   also included (pre-version 6.1 vintage):
  540.  
  541.                    --------------------------------------
  542.  
  543.                        * 64 Bit
  544.                        * IRIX 6.2 documents
  545.                        * IRIX 6.2-based software
  546.                        * Silicon Graphics Pipeline
  547.                          Articles
  548.                        * MIPS ABI documentation +
  549.                          patches subtree
  550.                        * educational/tutorials software
  551.                        * texture mapping / volume
  552.                          rendering
  553.                        * R10000 Microprocessor
  554.                          Documentation
  555.                        * Hi End Graphics Systems doc
  556.                        * Optimization / Performance
  557.                          Tuning
  558.                        * utilities[+src]
  559.                        * ViewKit
  560.                        * public
  561.                        * image data
  562.                        * OpenGL documents
  563.                        * OpenGL src
  564.                        * paul haeberli's universe/image
  565.                          stuff
  566.                        * video
  567.                        * audio
  568.                        * X
  569.                        * hardware
  570.                        * network
  571.                        * WWW
  572.                        * Performer
  573.                        * PERL
  574.                        * MAC
  575.                        * General IRIX/C/CC
  576.                        * IRIX 5.3
  577.                        * Open Inventor
  578.                        * speech recognition
  579.                        * software tools
  580.                        * Silicon Studio
  581.                        * printers
  582.                        * FAQs
  583.                        * games
  584.                        * exampleCode
  585.                        * demos
  586.                        * binaries
  587.                        * Multi Processor implementations
  588.                        * AND...
  589.  
  590.                    --------------------------------------
  591.  
  592. * 64 Bit:
  593.  
  594.    * MIPSpro 64-Bit Porting and Transition Guide, 3/96
  595.    * Is your X code ready for 64-bit?, 9/95
  596.    * IRIX 6.2 64-Bit Architecture and Standards Technical Report
  597.    * MIPSpro 64-Bit Porting and Transition Guide, 3/96
  598.  
  599. * IRIX 6.2 documents:
  600.  
  601.    * IRIX 6.2 New Features List document
  602.    * IRIX 6.2 64-Bit Architecture and Standards Technical Report
  603.    * MIPSpro N32 ABI Handbook, and an N32 overview
  604.    * MIPSpro 64-Bit Porting and Transition Guide, 3/96
  605.    * MIPSpro(TM) Compiling and Performance Tuning Guide, 3/96
  606.    * REACT(TM) Real-Time Programmer's Guide, 3/96
  607.    * Programming on Silicon Graphics Systems: An Overview, 3/96
  608.    * Topics in IRIX Programming , 3/96
  609.    * IRIX Admin Manual Set:
  610.         o IRIX Admin: System Configuration and Operation, 3/96
  611.         o IRIX Admin: Disks and Filesystems, 3/96
  612.         o IRIX Admin: Peripheral Devices, 3/96
  613.         o IRIX Admin: Networking and Mail, 3/96
  614.         o IRIX Admin: Backup, Security, and Accounting, 3/96
  615.         o IRIX Admin: Software Installation and Licensing, 3/96
  616.    * 6.2-rev'd versions of Dwarf Documents
  617.    * 6.2-based man pages on ELF (Executable and Linking Format)
  618.    * SGITCL Programmer's Guide, 3/96
  619.    * Documentation Catalog for IRIX 6.2 with accompanying "Manuals Summary"
  620.    * IRIX 6.2 Manuals Listing with accompanying "Manuals Summary"
  621.    * IRIX 6.2 Technical Publications BOM listing
  622.    * Preparing to Upgrade to IRIX 6.2 move from COFF to ELF with the
  623.      coffcheck script
  624.    * IRIX 6.2 Execution/Compilation Table for o32, n32, n64 with
  625.      MIPS{I,II,III,IV}
  626.    * The Coff Story -- End of Coff Support
  627.  
  628. * IRIX 6.2-based software:
  629.  
  630.    * libdwarf source from the 6.2 compiler_dev.src.dwarf subsystem
  631.    * contest, program teaches RapidApp/ViewKit/Motif
  632.    * iltest, IL/RapidApp/ViewKit tabbed deck w/ilVkComponent-derived widgets
  633.    * GLR, an OpenGL render server facility documentation and source
  634.  
  635. * Silicon Graphics Pipeline Articles:
  636.  
  637.    * Controlling a Program's Layout with ELSPEC, 11/95
  638.    * Kernel Processes in IRIX 5.3 and IRIX 6.1, 3/96
  639.    * IRIX Dynamically Loadable Kernel Modules, 3/95
  640.    * Kernel Tuning in IRIX 5.x and IRIX 6.0.x, 7/95
  641.    * Automating and Scheduling Jobs with Cron, 1/96
  642.    * Local and Remote File Locking, 3/96
  643.    * Restarting Sendmail, 3/96
  644.    * Getting Started With Socket Programming, 5/95
  645.    * Supported Releases, 11/95
  646.    * Getting and Setting User Context Within a Process, 7/95
  647.    * Using Automount, 9/95
  648.    * Configuration and Use of PPP, 9/95
  649.    * IRIX 5.3 NFS Version 3, 11/95
  650.    * Configuring Multiple Network Interfaces on SGI Systems, 11/95
  651.    * Multi-pipe Graphics Configurations, 3/95
  652.    * X11 Release 6, 5/95
  653.    * Monitor Update, 1/96
  654.    * (Almost) All About SCSI, 3/95
  655.    * Welcome to Performer 2.0, 3/96
  656.  
  657. * MIPS ABI documentation + patches subtree
  658.  
  659. * educational/tutorials software:
  660.  
  661.    * OpenGL Extensions Class FROM THE EXTENSIONS TO THE SOLUTIONS Training
  662.      Course materials for Impact, RE, & Infinite Reality, 2/96
  663.    * Performer 2.0 Class Source Code, 3/96
  664.    * IRIX 5.3-based software from Silicon Graphics Technical Education Dept
  665.      classes for:
  666.         o "OpenGL Programming 1 Course" (basics)
  667.         o "OpenGL Programming 2 Course" (addressing more advanced issues)
  668.         o "Open Inventor Programming Course" (Inventor 2.0-based)
  669.    * Open Inventor: lab source plus solutions
  670.    * geometer: graphical tutorial (including source) illustrates concepts of
  671.      2D Euclidean and projective geometry in 5.2-version now using jot
  672.  
  673. * texture mapping / volume rendering:
  674.  
  675.    * VOLREN, release 6, Volume Render with documentation and source
  676.    * Building an OpenGL Volume Renderer, 2/96
  677.    * Volume Rendering Primer, an example of hardware accelerated volume
  678.      rendering
  679.    * Interactive Volume Rendering Using Advanced Graphics Architectures
  680.    * Texture Mapping as a Fundamental Drawing Primitive
  681.    * Accelerated Vol. Rendering & Tomographic Recon. Using Texture Mapping
  682.      Hdw
  683.    * Interactive Geometric Image Transformation Using Texture Mapping
  684.    * Fast Shadows and Lighting Effects Using Texture Mapping
  685.    * Texture Mapping in Technical, Scientific and Engineering Visualization
  686.    * vidmap: texture-mapping of video, using Silicon Graphics
  687.      movie/video/compression/audio libraries; selection can be a live source
  688.      such as IndyCam(TM), other live video sources, or movie file (SGIMF,
  689.      QuickTime(TM)), to be texture-mapped to a polygon
  690.    * texvol: performs volume rendering using 2D or 3D textures
  691.    * swirl: IRIS GL texture generator program for texture maps
  692.    * 128tex: collection of small texture map images
  693.  
  694. * R10000 Microprocessor Documentation:
  695.  
  696.    * MIPS R10000 (T5) Next Generation Technology, 2/96
  697.    * R10000 Microprocessor User's Manual-Version 1.1, and 1.0
  698.    * Errata for Revision 1.0 of the R10000 Microprocessor User's Manual
  699.    * Mips Open RISC Technology R10000 Microprocessor Technical Brief
  700.  
  701. * Hi End Graphics Systems doc:
  702.  
  703.    * Fast VisSim On Impact Graphics, 4/96
  704.    * Impact Technical Report, Chapter 4, Impact Graphics Subsystem, 1995
  705.    * OpenGL Extensions Class FROM THE EXTENSIONS TO THE SOLUTIONS Training
  706.      Course materials for Impact, RE, & Infinite Reality, 2/96
  707.    * Onyx Platform, Graphics, and General Specifications Tables, 2/96
  708.  
  709. * Optimization / Performance Tuning:
  710.  
  711.    * Optimization for Real-Time Graphics Applications, 2/96
  712.    * Performance optizations, implementation, and verification of the
  713.      Silicon Graphics Challenge multiprocessor
  714.    * showcase slide set used to teach program performance tuning
  715.    * gldebug: cheat sheet, useful for both debugging and tuning, and scripts
  716.      to parse and quantify gldebug.history data
  717.    * glprog: cheat sheet, useful for profiling IRIS GL applications
  718.    * 100+ showcase "pages" on Challenge« I/O performance+scripts+PS files
  719.    * document on benchmark results on 100/150 Mhz Challenge L/XL servers and
  720.      Onyx(TM)
  721.  
  722. * utilities[+src]:
  723.  
  724.    * efscopy: powerful/QUIK cloning tool for entire disk's contents
  725.    * IRIS InSight Professional Publisher Product Evaluation Software
  726.    * CDmastering: scripts and binaries make efs and iso-9660 filesystem
  727.      images, and also can handle sa files (putting sashes on the volume
  728.      header, etc.)
  729.    * VCal: a simple calendar program with alarms
  730.    * cmapdoctor: scanner/viewer for all X cmaps/visuals (over/underlays,
  731.      popups)
  732.    * coffcheck: find+replace COFF executables with ELF on local file systems
  733.    * cd-catalog, music catalog files for CDman(1) & cdplayer(1)
  734.    * fconv: numeric format conversion utility for hex/octal/decimal
  735.      equivalents
  736.    * gmemusage: graphical memory usage display tool
  737.    * gvi: provides a graphical user interface to the vi(1) text editor
  738.    * parasol: analyzes FORTRAN src to aide parallel porting; static analyzer
  739.      identifies global data dependencies in Fortran from specified thread
  740.      point valuable in identifiying common blocks to be made local or to be
  741.      locked
  742.    * setfb: sets the effective frame buffer depth to 8 or 24 bitplanes
  743.    * sgihelp_dev: IRIX 5.2-based SGIHelp development tools as inst-able
  744.      images to integrate help w/an app in the Indigo Magic(TM) User
  745.      Environment
  746.    * short_timeout: checks if remote host responds quickly, avoids long
  747.      timeout
  748.    * uil2VK: viewkit experimental replacement code generator module used
  749.      with BuilderXcessory so BX can generate compatible code with IRIX
  750.      ViewKit(TM)
  751.    * xshowcmap: extension, for debugging probs with multiple
  752.      colormaps/visuals
  753.  
  754. * Viewkit:
  755.  
  756.    * IRIS ViewKit Technical Report
  757.    * pfview, a performer 2.0 viewer using OGL/RapidApp/ViewKit
  758.    * contest, program teaches RapidApp/ViewKit/Motif
  759.    * iltest, IL/RapidApp/ViewKit tabbed deck w/ilVkComponent-derived widgets
  760.    * uil2VK: viewkit experimental replacement code generator module used
  761.      with BuilderXcessory so BX can generate compatible code with IRIX
  762.      ViewKit(TM)
  763.    * VCal: a calendar program with alarms
  764.    * builderExamples: programs written using BuilderXcessory
  765.    * other Vk app source: cmapdoctor, gvi, oat, uucpVadmin
  766.  
  767. * public:
  768.  
  769.    * Silicon Graphics Anonymous FTP Sites, 8/6/96
  770.    * figlet: a program for making large letters out of ordinary text
  771.    * GNU emacs: version 19.28 of the GNU editor (inst images w/src).
  772.    * psgl: version 2.1 of the IRIS GL to Postscript Library
  773.    * TIFF: v3.30beta returns (v4.2 version now re-included)
  774.    * HylaFAX: version 3.0pl1 of the the HylaFAX facsimile software system
  775.    * Chaos: The Chaotic Music Generator, Version 1.0
  776.    * rsynth: Rsynth speech synthesizer ported to SGI, Version 1.0
  777.    * xd: the hexidecimal dump and load program
  778.    * xanim: display various types of animations formats in an X11
  779.      environment
  780.    * Silicon Graphics Freeware Version 1.0 includes these instable software
  781.      packages:
  782.        1. GNU bash, v1.14.5 -- enhanced shell
  783.        2. GNU binutils, v2.5.2 -- object file utilities
  784.        3. GNU bison, v1.22 -- improved yacc
  785.        4. calls, v3.8 -- outputs call graph of functions in a C program
  786.        5. Cspect -- real-time oscilloscope/spectrum analyzer
  787.        6. elm, v2.4PL24 ME5a -- full-screen, text-based electronic mail
  788.           client
  789.        7. expect, v5.18 -- Tcl tool for programmed dialogue w/interactive
  790.           progs
  791.        8. exmh, v1.6.2 -- TCL/TK based interface to the MH mail system
  792.        9. GNU fileutils, v3.12 -- file handling utilities
  793.       10. GNU findutils, v4.1 -- find, xargs, locate
  794.       11. GNU flex, v2.5.2 -- improved lexical analyzer generator
  795.       12. freeze/melt, v2.3.1 -- compression/decompression program
  796.       13. fw_common -- pre-requiste subsystem needed to install any fw_* sw
  797.       14. GNU gawk, v2.1.15 -- GNU version of awk
  798.       15. GNU gcc, v2.6.3 -- C and C++ compiler
  799.       16. GNU gdb, v4.14 -- debugger
  800.       17. ghostscript, v3.33 -- PostScript interpreter
  801.       18. ghostview, v1.5 -- X-Window user interface for ghostscript
  802.       19. glimpse, v3.0 -- file indexing and query system
  803.       20. gnuplot, v3.5 -- function plotting program
  804.       21. gopher, v1.1.2 -- gopher client and server software
  805.       22. GNU grep, v2.0 -- gnu grep
  806.       23. GNU groff, v1.09 -- doc tools replace {n,t,ps}roff, eqn, tbl, etc.
  807.       24. html2ps, v0.2 -- HTML to PostScript converter
  808.       25. GNU indent, v1.9.1 -- C reformatter
  809.       26. ispell, v3.1 -- screen-based spell checker
  810.       27. GNU less, v290 -- Like more(1) but better
  811.       28. GNU libg++, v2.6.2 -- libraries for use with the GNU C++ compiler
  812.       29. llnlxftp, v2.0.4 -- an X ftp client
  813.       30. lps, v1 -- Linux ps
  814.       31. lynx, v2.4.2 -- terminal WEB browser curses based ASCII
  815.       32. mcvert, v2.16 -- Macintosh file format translator
  816.       33. metamail, v2.7 -- implementation of MIME
  817.       34. mh, v6.8.3 -- Message Handling pkg for e-mail, b-boards, etc
  818.       35. mpage, v2.0 -- multiple page postscript processor
  819.       36. mpegaudio -- mpeg encoder/decoder does LayerI&II audio
  820.       37. netpbm, v1mar1994 -- image conversion toolkit between many formats
  821.       38. nfswatch, v4.1 -- monitor NFS requests
  822.       39. perl5, v5 patchlevel 001m -- Practical Extraction and Report
  823.           Language
  824.       40. plan, v1.4.2 -- calendar/planning
  825.       41. python, v1.2 -- interpreted OO language like Tcl, Perl or Scheme
  826.       42. qpopper, v2.1.4 -- POP (Post Office Protocol) server
  827.       43. rzsz, v9306 -- implementation of the zmodem protocol.
  828.       44. sc, v6.21 -- spread sheet program
  829.       45. GNU screen, v3.7.1 -- terminal multiplexer
  830.       46. GNU sed, v2.05 -- UNIX standard stream editor
  831.       47. seyon, v2.14c -- telecommunications
  832.       48. GNU sharutils, v4.1 -- shell archiver/de-archiver
  833.       49. GNU shutils, v1.12 -- shell utilities
  834.       50. sono -- generate a score from electroacoustic piece
  835.       51. sox10, v1.0-ircam -- universal sound converter
  836.       52. GNU tar, v1.11.8 -- improved tar
  837.       53. tex/latex v3.1415 -- document preparation system
  838.       54. GNU texinfo, v3.6 -- text based hypertext system
  839.       55. GNU textutils, v1.12 -- text utilities
  840.       56. tin, v1.2PL2 -- news reader
  841.       57. tk, v4.0p2 -- X11 toolkit on TCL
  842.       58. top, v3.3 -- dynamic process status
  843.       59. tracker, v4.31 -- modfile-player
  844.       60. turn, v1.0 -- news reader
  845.       61. unzip, v3.0 -- archive utility
  846.       62. viewfax, v2.3 -- view facsimile-oriented images in X
  847.       63. vim, v3.0 -- vi improved
  848.       64. weblint -- perl script checks html files for errors
  849.       65. wu-ftpd, v2.4 -- for Un*x systems replacement ftp server
  850.       66. xarchie, v210.10 -- prosero client
  851.       67. xdaliclock -- digital clock, digit changes melts to new digits
  852.       68. xearth, v0.92 -- rotating globe
  853.       69. xemacs, v19.13 -- text editor
  854.       70. xfig, v3.1.4 -- draw and manipulate objects interactively in X
  855.       71. xgopher, v1.3.3 -- search engine
  856.       72. xkeycaps, v2.29 -- graphical tool to change xmodmap files
  857.       73. xless -- a graphical version of GNU less
  858.       74. xli, v1.16 -- xloadimage
  859.       75. xmorph -- image morphing
  860.       76. xpm -- drop-in replacement for IRIX 5.3 xpm library
  861.       77. xtail, v2.1 -- eXtended tail of standard UNIX 'tail -f'
  862.       78. xv, v3.10a -- interactive image display for the X Window System
  863.       79. zip, v2.0.1 -- archive utility
  864.    * Silicon Graphics Freeware Version 2.0 includes these instable software
  865.      packages:
  866.        1. GNU bash, v1.14.5 -- enhanced shell
  867.        2. GNU bison, v1.22 -- improved yacc
  868.        3. calls, v3.8 -- outputs call graph of functions in a C program
  869.        4. Cspect -- real-time oscilloscope/spectrum analyzer
  870.        5. db, v1.85 -- Berkeley db
  871.        6. elm, v2.4PL24 ME5a -- full-screen, text-based electronic mail
  872.           client
  873.        7. expect, v5.18 -- Tcl tool for programmed dialogue w/interactive
  874.           progs
  875.        8. exmh, v1.6.2 -- TCL/TK based interface to the MH mail system
  876.        9. GNU fileutils, v3.12 -- file handling utilities
  877.       10. GNU findutils, v4.1 -- find, xargs, locate
  878.       11. GNU flex, v2.5.2 -- improved lexical analyzer generator
  879.       12. freeze/melt, v2.3.1 -- compression/decompression program
  880.       13. fw_common -- pre-requiste subsystem needed to install any fw_* sw
  881.       14. GNU emacs v19.13, v19.30 -- Gnu version of emacs text editor
  882.       15. GNU gawk, v2.1.15 -- GNU version of awk
  883.       16. GNU gcc, v2.6.3 -- C and C++ compiler
  884.       17. GNU gdb, v4.14 -- debugger
  885.       18. ghostscript, v3.33 -- PostScript interpreter
  886.       19. ghostview, v1.5 -- X-Window user interface for ghostscript
  887.       20. glimpse, v3.0 -- file indexing and query system
  888.       21. gnuplot, v3.5 -- function plotting program
  889.       22. gopher, v1.1.2 -- gopher client and server software
  890.       23. GNU grep, v2.0 -- gnu grep
  891.       24. GNU groff, v1.09 -- doc tools replace {n,t,ps}roff, eqn, tbl, etc.
  892.       25. html2ps, v0.2 -- HTML to PostScript converter
  893.       26. ImageMagick, v3.7.2 --JPEG/PNG/TIFF/Photo CD image pkg
  894.       27. GNU indent, v1.9.1 -- C reformatter
  895.       28. ispell, v3.1 -- screen-based spell checker
  896.       29. GNU less, v290 -- Like more(1) but better
  897.       30. GNU libg++, v2.6.2 -- libraries for use with the GNU C++ compiler
  898.       31. llnlxftp, v2.0.4 -- an X ftp client
  899.       32. lps, v1 -- Linux ps
  900.       33. lynx, v2.4.2 -- terminal WEB browser curses based ASCII
  901.       34. mcvert, v2.16 -- Macintosh file format translator
  902.       35. metamail, v2.7 -- implementation of MIME
  903.       36. mh, v6.8.3 -- Message Handling pkg for e-mail, b-boards, etc
  904.       37. mpage, v2.0 -- multiple page postscript processor
  905.       38. mpegaudio -- mpeg encoder/decoder does LayerI&II audio
  906.       39. nas, v1.2p4 -- implementation of Network Audio System
  907.       40. nedit, v4.0.1 -- GUI style plain text editor
  908.       41. netpbm, v1mar1994 -- image conversion toolkit between many formats
  909.       42. nfswatch, v4.1 -- monitor NFS requests
  910.       43. perl5, v5 patchlevel 001m -- Practical Extraction and Report
  911.           Language
  912.       44. plan, v1.4.2 -- calendar/planning
  913.       45. python, v1.2 -- interpreted OO language like Tcl, Perl or Scheme
  914.       46. qpopper, v2.1.4 -- POP (Post Office Protocol) server
  915.       47. rzsz, v9306 -- implementation of the zmodem protocol.
  916.       48. samba, v1.9.15p8 -- SMB client and server
  917.       49. sc, v6.21 -- spread sheet program
  918.       50. GNU screen, v3.7.1 -- terminal multiplexer
  919.       51. GNU sed, v2.05 -- UNIX standard stream editor
  920.       52. seyon, v2.14c -- telecommunications
  921.       53. GNU shutils, v1.12 -- shell utilities
  922.       54. sono -- generate a score from electroacoustic piece
  923.       55. sox10, v1.0-ircam -- universal sound converter
  924.       56. GNU tar, v1.11.8 -- improved tar
  925.       57. tcp_wrappers, v7.2 -- TCP/IP daemon wrapper package
  926.       58. tex/latex v3.1415 -- document preparation system
  927.       59. GNU texinfo, v3.6 -- text based hypertext system
  928.       60. GNU textutils, v1.12 -- text utilities
  929.       61. tin, v1.2PL2 -- news reader
  930.       62. tk, v4.0p2 -- X11 toolkit on TCL
  931.       63. top, v3.3 -- dynamic process status
  932.       64. tracker, v4.31 -- modfile-player
  933.       65. turn, v1.0 -- news reader
  934.       66. unzip, v3.0 -- archive utility
  935.       67. viewfax, v2.3 -- view facsimile-oriented images in X
  936.       68. vim, v3.0 -- vi improved
  937.       69. weblint -- perl script checks html files for errors
  938.       70. wu-ftpd, v2.4 -- for Un*x systems replacement ftp server
  939.       71. xarchie, v210.10 -- prosero client
  940.       72. xdaliclock -- digital clock, digit changes melts to new digits
  941.       73. xearth, v0.92 -- rotating globe
  942.       74. xemacs, v19.13 -- text editor
  943.       75. xfig, v3.1.4 -- draw and manipulate objects interactively in X
  944.       76. xgopher, v1.3.3 -- search engine
  945.       77. xkeycaps, v2.29 -- graphical tool to change xmodmap files
  946.       78. xless -- a graphical version of GNU less
  947.       79. xli, v1.16 -- xloadimage
  948.       80. xmorph -- image morphing
  949.       81. xntp, v3.4o -- Network Time Protocol
  950.       82. xpm -- drop-in replacement for IRIX 5.3 xpm library
  951.       83. xtail, v2.1 -- eXtended tail of standard UNIX 'tail -f'
  952.       84. xv, v3.10a -- interactive image display for the X Window System
  953.       85. zip, v2.0.1 -- archive utility
  954.  
  955. * image data:
  956.  
  957.    * earth from space: satellite image mosaics of earth from space created
  958.      from visible and infrared channels, by [data/images/]WorldSat, with sea
  959.      surface temperature data added for ocean areas & base satellite imagery
  960.      enhanced with shaded relief data
  961.    * rgb+gif+jpg: tons o' images in src/haeberli/{images,grafica/gallery}
  962.    * src/haeberli/128env: cubical format environment maps
  963.    * src/haeberli/128sph: 128x128 spherical environment maps
  964.    * src/haeberli/128tex: 128x128 texture maps
  965.    * src/haeberli/512sph: 512x512 spherical environment maps
  966.  
  967. * OpenGL documents:
  968.  
  969.    * OpenGL Specification, 12/21/95
  970.    * GLU Specification, 10/93
  971.    * GLX Specification, 1/95
  972.    * Extensions, 3/28/96
  973.    * GLC Specification, 12/95
  974.    * OpenGL on Silicon Graphics Systems, 3/96 -- advanced topics
  975.    * OpenGL: FROM THE EXTENSIONS TO THE SOLUTIONS Training Course materials,
  976.      8/96
  977.    * GLR, an OpenGL render server facility
  978.    * OpenGL Render Serving with GLR
  979.    * OpenGL Render Serving "Frequently Asked Questions"
  980.    * The OpenGL Utility Toolkit (GLUT) Programming Interface API Version 3,
  981.      February, 1996
  982.    * GLUT-based articles from the OpenGL and X Column in The X Journal:
  983.         o Column 1: An OpenGL Toolkit, December, 1994
  984.         o Column 2: Let there be light!, January/February, 1995
  985.         o Column 3: Texture Mapping, March/April, 1995
  986.         o Column 4: Blending, Antialiasing, And Fog, May/June, 1995
  987.         o Column 5: Extensions To OpenGL, July/August, 1995
  988.         o Column 6: Hardware For Accelerating OpenGL, September/October,
  989.           1995
  990.         o Column 7: Using Open Inventor with GLUT, November/December, 1995
  991.         o Column 8: Curves and Surfaces in OpenGL, January/February, 1996
  992.         o Column 9: EXIT: A 3D standard for X (finally!), March/April, 1996
  993.    * System Support for OpenGL Direct Rendering, September, 1994
  994.    * 3-part series on OpenGL and X, from The X Journal:
  995.         o Part 1: An Introduction, November/December, 1993
  996.         o Part 2: Using OpenGL with Xlib, January/February, 1994
  997.         o Part 3: Integrating OpenGL with Motif, July/August, 1994
  998.    * X Server Multi-rendering for OpenGL and PEX, 8th X Technical
  999.      Conference, January, 1994
  1000.    * OpenGL Man Pages (from the EXTensions to the SOLutions Training Course)
  1001.    * Notes on Porting RealityEngine Applications to OpenGL, April 20, 1995
  1002.    * support for VGX, Personal IRIS, 64-bit, and FORTRAN, 9/19/94
  1003.    * The Three DSOs Currently (as of 10/94) supporting the OpenGL core
  1004.    * Implementation Notes for OpenGL Programmers, July, 1994
  1005.    * OpenGL Widget Man Pages [4]
  1006.    * OpenGL FAQ
  1007.    * IrisGL-to-OpenGL mapping of routines
  1008.    * Proposal for an OpenGL FORTRAN Binding, September, 1994
  1009.    * How OpenGL differs from IrisGL, May, 1992
  1010.    * OpenGL: The Graphics Standard, 11/94
  1011.    * OpenGL and X, A Technical Overview of OpenGL and the X Window System,
  1012.      1/94
  1013.    * How OpenGL integrates with the X Window System, 1/94
  1014.    * The OpenGL Graphics Interface, (introduction to OpenGL)
  1015.    * The Design of OpenGL Graphics Interface, (philosphy and details)
  1016.  
  1017. * OpenGL src:
  1018.  
  1019.    * sample code for IRIX 5.3 extensions + patch154
  1020.    * lmwrap: demos porting IRIS GL's lmdef() + lmbind() calls to OpenGL
  1021.    * render2pixmap: OpenGL offscreen rendering example
  1022.    * contcapt: converted OpenGL version of the VL contcapt program
  1023.    * 2Dwrap, "before-after" porting example for Iris-to-OpenGL 2d primitives
  1024.    * defrasterPort: [3] progs use bitmaps for IRIS GL defrasterfont()[1] in
  1025.      OpenGL[2] or X[3]
  1026.    * toogl: TO OpenGL IRIS GL(TM) translator
  1027.    * oat: OpenGL Attribute Tester tests OpenGL functionality on different
  1028.      platforms
  1029.    * pick: picking prog w/X overlay on top of RGBA, double and
  1030.      depth-buffered window
  1031.    * ipaste_ogl: opengl-based version of ipaste
  1032.    * dinomometer: synthetic modeling benchmark for OpenGL
  1033.    * textfun: a "poor man's OpenGL Motif(TM) font manager" program
  1034.    * xmblur: OpenGL Motif motion-blur program
  1035.    * debugHelper: overrides DSO functions to trace OpenGL program calls
  1036.      without having to recompile
  1037.    * xlib: 40 OpenGL and Xlib only example programs, including two
  1038.      implementing pure-Xlib version of "IrisGL type" pup menu capability
  1039.    * libGLColorChooser.a: an OpenGL implementation of the SgColorChooser
  1040.      widget
  1041.    * glx: 2 implementations of OpenGL GLX extensions
  1042.    * nurbsTrim: makes a trimmed NURBS surfaces in OpenGL and Inventor
  1043.    * article src: accompanying src to "OpenGL and X, Part 1/Part 2/Part3," X
  1044.      Journal articles
  1045.    * stereo: software-stereo-in-a-window boilerplate examples in OpenGL
  1046.      Motif
  1047.    * cap: opengl motif-based interference checking demo
  1048.    * DBglxwidgetOpenGL: Xt/Motif widget for GL/OpenGL rendering, switchable
  1049.      between single or double buffering
  1050.    * renderboth: renders with X and OpenGL to the same window using a
  1051.      standard Motif XmDrawingArea widget as the rendering medium
  1052.    * example src: LARGE OpenGL tree of src (Xlib-only as well as Motif),
  1053.      documentation, and articles, isfast (performance measure routines), and
  1054.      xglinfo (displays info about an X server supporting the OpenGL
  1055.      extension, especially w.r.t. visuals)
  1056.  
  1057. * paul haeberli's universe/image stuff:
  1058.  
  1059.    * pstools: 25 PostScript Processing Tools combining operations with/on
  1060.      PostScript files with IRIS GL
  1061.    * Spec.{html , txt}: definitive doc describing Silicon Graphics image
  1062.      file format
  1063.    * imgscr: 26 scripts use imgtools & pstools progs to perform extended
  1064.      image processing
  1065.    * imgtools: 218 image processing tools for the IRIS
  1066.    * GRAPHICA Obscura, Collected Computer Graphics Hacks: w/links to src
  1067.    * fonttools: 27 progs do operations with/on polygonal outline fonts &
  1068.      IRIS GL
  1069.    * jpeg: format img de-/compression sw src + support for SG img files
  1070.      to/from jpeg
  1071.    * envtools: programs to manipulate environment maps
  1072.    * vidpan: tools for controlling a Panasonic Video disc recorder
  1073.    * vidsony: tools to control SONY LVR-5000 Video disc recorder
  1074.    * mpeg: public domain MPEG video software decoder
  1075.    * {libimage, libgutil, libcan, libtiff}: complete source
  1076.    * images: over 63MB of SGI RGB image files + jpg&gif forms
  1077.    * 128sph: collection of spherical environment map images
  1078.    * 128tex: collection of small texture map images
  1079.    * 128env: cubical format environment maps
  1080.    * gobs of programs in haeberli/{abekas, envtools, impression, objtools,
  1081.      tools, vidtools}, plus autopaint, compexp, enhance, imp, leep, movie,
  1082.      mtex, styline, tritest, vidiot, vortest
  1083.    * ibrowse: extraHEEMEly swank image file browser
  1084.    * src/apps/opaste: pastes images/text into the overlay/popup planes
  1085.  
  1086. * video:
  1087.  
  1088.    * cineswipe: records [Open]GL app's gfx to movie file w/out touching app
  1089.      itself
  1090.    * contcapt: converted OpenGL version of the VL contcapt program
  1091.    * simpleVideo: library + examples provide video prog'er w/simple
  1092.      programmatic interface on top of the VL
  1093.    * seqgrab: VL sequential frame accurate capture source (Galileo
  1094.      Video(TM)/VLAN)
  1095.    * galileo demo source: galileo.sw.demos video progs src using VL+Motif or
  1096.      VL+IRIS GL demo'ing special effects like chroma and luma keying, blends
  1097.      & transitions, and also capturing video frames for painting or putting
  1098.      onto 3D geometry (Galileo/Indigo▓ Video(TM)/Indy Video)
  1099.    * vidmap: texture-mapping of video, using Silicon Graphics
  1100.      movie/video/compression/audio libraries; selection can be a live source
  1101.      such as IndyCam(TM), other live video sources, or movie file (SGIMF,
  1102.      QuickTime(TM)), to be texture-mapped to a polygon
  1103.    * scrollmon: creates realtime scrolling credits (from either anti-aliased
  1104.      text or Silicon Graphics rgb images) or titles for video production
  1105.    * SGI DIGITAL VIDEO Specificiation: 1995 version 1.1 including data
  1106.      format and electrical and mechanical interfaces used to get digital
  1107.      video data into and out of Silicon Graphics platforms via this 60-pin
  1108.      connector
  1109.  
  1110. * audio:
  1111.  
  1112.    * Audio and Music Applications for Silicon Graphics Systems documentation
  1113.    * SGI Desktop Audio Hardware Performance Specifications (Typical),
  1114.      Indigo▓, Indy, 3/93
  1115.    * midi: example progs using libmidi.a illustrate basic use of MIDI
  1116.      library
  1117.    * harmonizer: real-time audio pitch bender example program
  1118.    * sonic: real time audio spatialization example with graphics
  1119.    * DAT examples: command interface, copying, and DAT checking programs
  1120.    * reverb: simulated reverberation source code for real-time audio
  1121.    * ascope: displays the left channel of data coming in from an audio port
  1122.    * rock: indigo memorial barbeque theme song rapp as constructed and sung
  1123.      by mr. totally insane(tm) himself
  1124.    * cd-catalog, music catalog files for CDman(1) & cdplayer(1)
  1125.    * audio apps: including a generator of a small series of eight
  1126.      single-cycle waveforms, and progs generating oscillators and waveforms,
  1127.      loop audio samples change playback rate, mix and pitch, and sends
  1128.      output to the speaker
  1129.    * Audio Interchange File Format AIFF-C, A revision to include compressed
  1130.      audio data
  1131.  
  1132. * X:
  1133.  
  1134.    * rgb2pix turns rgb files into X11 Pixmaps
  1135.    * Is your X code ready for 64-bit?, 9/95
  1136.    * What's New with X11R6 for IRIX 6.0 and 5.3, based on X Window System,
  1137.      Version 11, Release 6 Release Notes with SGI Annotations
  1138.    * The Past, Present, and Future of Window Systems at Silicon Graphics,
  1139.      6/94
  1140.    * cursor: two programs -- one using "Font," the other "Pixmap"
  1141.    * font: two programs, one working with glyphs, the other doing scalable
  1142.      fonts
  1143.    * paper and src: discusses/demos implementation of a 3-color cursor in X
  1144.    * XtAppInitwIcon: src similiar to XtAppInitialize but enables app to
  1145.      generate icon window for top-level shell that generates multicolored (>
  1146.      2) icons
  1147.    * X perf: information/documentation pertinent to X and system performance
  1148.      issues includes an SGI internal paper on "Motif Performance Notes"
  1149.    * papers on SGI's Xserver:
  1150.         o Going Beyond the MIT Sample Server: The Silicon Graphics X11
  1151.           Server
  1152.         o Programming X Overlay Windows, explains Silicon Graphics
  1153.           SERVER_OVERLAY_VISUALS usage convention to portably create X
  1154.           windows in the overlay planes
  1155.         o A Fully Functional Implementation of Layered Windows, explains
  1156.           semantic basis for Silicon Graphics current X server support for
  1157.           layered windows
  1158.         o X Server Multi-rendering for OpenGL and PEX
  1159.    * X11R5 Input Extension Library PostScript files:
  1160.         o X11 Input Extension Library Specification
  1161.         o X11 Input Extension Porting Document
  1162.         o "Appendix A, Input Extension Protocol Encoding"
  1163.         o X11 Input Extension Protocol Specification
  1164.  
  1165. * hardware:
  1166.  
  1167.    * IRIX 6.2 version of IRIX(TM) Device Driver Programming Guide, 3/96
  1168.    * IRIX 5.3 version of IRIX(TM) Device Driver Programming Guide, 1994
  1169.    * Software Solutions to EISA Hang Problems
  1170.    * 5.3 Summagraphics tablet driver + "using X input/config files" info
  1171.    * IRIX 5.3 Comtrol Hostess 550 Serial Port Board EISA/ISA driver
  1172.    * dat.kernel: contains a sample SCSI kernel-level driver
  1173.    * Hardware Developers Handbook: Version 1.0, contains most comprehensive
  1174.      compilation of Silicon Graphics hardware information ever assembled in
  1175.      one document
  1176.    * dat.kernel, sample SCSI kernel-level DAT driver controls DAT tape drive
  1177.    * dat: User-Level SCSI DAT driver, example of how to use the devscsi
  1178.      library
  1179.    * rap: Roland RAP-10 ISA driver - an example of how to do DMA on the EISA
  1180.      bus
  1181.    * DevDriver: pre-IRIX 5.3 inst images of IRIX Device Driver Programming
  1182.      Guide and Reference Pages
  1183.    * cdmount/mountMO: allows joe user (doesn't have to be root) to mount
  1184.      either a CDROM or a Magneto-Optic (MO) drive on a Silicon Graphics
  1185.      system
  1186.    * parallel port: example of how to program for the parallel port
  1187.    * monitor calibration: information on how to calibrate the Sony monitors
  1188.    * FAQ: expanded Silicon Graphics Hardware FAQ including a list of Q&As
  1189.      culled from the last 1,800 messages (as of late 10/93) to
  1190.      comp.sys.sgi.hardware
  1191.    * GIO: files describing how to write a device driver for a GIO board on
  1192.      an IRIX 5 system software platform and IRIX 4.0.5
  1193.    * VME: VME interface document for the Personal IRIS, 4D100-4D400 series
  1194.      machines and Crimsons (does NOT cover IO4 board)
  1195.  
  1196. * network:
  1197.  
  1198.    * Scalability in the XFS File System, 1/96
  1199.    * XFS Data Sheet and Technical Specificationss
  1200.    * Internet Request For Comments RFC & FYI archives, contains open
  1201.      standards used on the Internet today, + doc on virtually every aspect
  1202.      of the Internet, since its inception, up throught rfc1918 (current up
  1203.      to 2/29/96)
  1204.    * HIPPI Performance on IRIX 5.2 white paper, + 2 accompanying source
  1205.      progs
  1206.    * "Establishing a PPP connection using IRIX PPP" paper
  1207.    * "SLIP Installation and Configuration Guide" paper
  1208.    * Asynchronous Transfer Mode: Implementations for 1994 PostScript
  1209.      document
  1210.    * xconfr: a TCP->UDP xconf router so people can use it over the Internet
  1211.    * pcnfsd: PC-NFS(TM) daemon providing authentication and print spooling
  1212.      services access from one's PC to IRIX when used with Sun's PC-NFS
  1213.      software
  1214.    * short_timer: checks if remote host responds quickly, avoiding long wait
  1215.      for network timeout
  1216.    * rpcdemo: rpcdemo and printout link-level address of e-net or FDDI
  1217.      interface
  1218.    * xconf: X-based local area network conferencing program
  1219.  
  1220. * WWW:
  1221.  
  1222.    * 20-or-so Java applets, a collection of java snippet code, and
  1223.      documentation
  1224.    * Hypertext Markup Language 2.0 Specification, 9/95
  1225.    * mostools, mr. totally insane(TM)'s Image Production for the Web tools
  1226.    * CGI docs & tutorial, + viewable copies of DT CGI-script files
  1227.    * The cgi-bin directory of scripts used in/by the DT
  1228.    * HTML:
  1229.         o A Beginner's Guide to HTML
  1230.         o HTML Quick Reference
  1231.         o HTML, the complete-ish guide
  1232.    * Building an Internet Firewall document
  1233.    * NCSA's httpd server documentation, version 1.3
  1234.    * A Beginner's Guide to URLs
  1235.    * World Wide Web FAQ (1/23/95)
  1236.    * WWW contains URL's pertaining to HTML/CGI/WWW tutorials, examples
  1237.  
  1238. * Performer:
  1239.  
  1240.    * Performer 2.0 Class Source Code, 3/96
  1241.    * pfview, a performer 2.0 viewer using OGL/RapidApp/ViewKit
  1242.    * IRIS Performer 2.0 Technical Report, API, Technical Information and
  1243.      Release Notes.
  1244.  
  1245. * PERL:
  1246.  
  1247.    * Perl Patterns (1996) and Perl 5 documentation
  1248.    * IRIX 6.2-built perl5, v5 patchlevel 001m
  1249.    * IRIX 5.3-built perl5, v5 patchlevel 001m
  1250.  
  1251. * MAC:
  1252.  
  1253.    * UNIX Tools For Former MAC Developers, 1996
  1254.  
  1255. * General IRIX/C/CC:
  1256.  
  1257.    * Caching and Locality (11/94) discusses issues surrounding computer
  1258.      memory
  1259.    * "The Paging Game," very old but a useful way of thinking about memory
  1260.      pages
  1261.    * IRIS Periodic tables for Workstation/Client, Challenge Server, Onyx
  1262.      Family, Power Challenge
  1263.    * context -- getting and setting user context within a process program
  1264.    * fileLocking -- local and remote file locking programs
  1265.    * sockets -- introduction to sockets with a client and a server program
  1266.    * wrapper, a C wrapper around a C++ class
  1267.    * Installing and Running IRIX on a Drive Other Than Drive 1
  1268.    * load_avg: src to obtain the current system load average
  1269.    * IRIX Operating System Periodic Table, 11/94
  1270.    * file describing colormap usage differences between 5.1* and 5.2
  1271.    * list of 5.2 IRIX patches, information current as of 7/20/94
  1272.    * irix src: tree with shell scripts, UUCP vadmin tool, irix/system-level
  1273.      programs
  1274.    * playEngine: sproc/semaphore src can raise sub-process's priority to
  1275.      circumvent preemption
  1276.    * C/C++/Make: docs directory on c++-rules.ps, C++ Exception Handling,
  1277.      Silicon Graphics Inc, Common Makefile include files, Notes, Silicon
  1278.      Graphics Makefile Conventions, and cpp/csh/make/pmake quick references
  1279.    * irix5.2 + Products Info directory includes:
  1280.         o 2 files on HIPPI: New Product Bulletin + QnA's
  1281.         o question-and-answer on the Indigo Magic User Environment Interface
  1282.         o major changes between the 4.X and 5.2 versions of the Installation
  1283.           Guide
  1284.         o IRIS Media Libraries New Product Information on dmedia_dev and
  1285.           svideodev
  1286.         o Software Compatibility Matrix for software product numbers and
  1287.           software releases from 4.0.1 to 5.2
  1288.         o Field Information Bulletin #414 documenting known bug: "Indigo▓
  1289.           XZ/Extreme(TM) stipple register causes graphics problems on IRIX
  1290.           5.2"
  1291.         o guidelines for the use of the /usr/share filesystem
  1292.  
  1293. * IRIX 5.3:
  1294.  
  1295.    * Documentation Catalog for IRIX 5.3 with accompanying "Manuals Summary"
  1296.    * IRIX 5.3 Manuals Listing with accompanying "Manuals Summary"
  1297.    * IRIX 5.3 Technical Publications BOM listing
  1298.    * REACT(TM) in IRIX 5.3 Technical Report for real-time extensions to IRIX
  1299.      5.3
  1300.    * Using Asynchronous I/O and Direct I/O in IRIX 5.X
  1301.    * New Product Information for IRIX 5.3 data sheet and white paper
  1302.  
  1303. * Open Inventor:
  1304.  
  1305.    * ivIndpTri: tesselation utility for Inventor scene graphs which
  1306.      implements an Independent Triangle Class
  1307.    * Spaceball: modified src from inventor_dev.src.sample handles Spaceball
  1308.      input device
  1309.    * DirectManipRevoSurf: OpenIV prog uses draggers for direct manipulation
  1310.      of a surface of revolution (with its own run-time DSO)
  1311.    * DirectManipTrackLight: Open Inventor files demo interactive direct
  1312.      manipulation of a Track Light
  1313.    * models: sample OpenIV files demo use of draggers+engines in
  1314.      "self-manip'ing" examps
  1315.    * lab: Open Inventor lab source plus solutions
  1316.    * 38-page showcase presentation on "Open Inventor 3d Toolkit"
  1317.    * noodle: an easy-to-use 3D object-modeler rich in using Open Inventor
  1318.    * How to Write an Open Inventor File Translator
  1319.    * Open Inventor Nodes Quick Reference Guide
  1320.    * sharedSV: shared scene viewer lets multiple users on the net
  1321.      view/change same iv file
  1322.    * soundspheres: a very primitive spacial audio program in Open Inventor
  1323.    * DxfToIv: binary/man page, converts AutoCad's DXF format files to IV
  1324.      files
  1325.  
  1326. * speech recognition:
  1327.  
  1328.    * 1995 inst images of SGI's Speech Recognition Project
  1329.    * lackey: speech aware app launcher developed using Silicon Graphics
  1330.      speech recog software. An intro to using speech API and architecture of
  1331.      the speech software system
  1332.    * binary utilities: to enhance one's speech run-time environment
  1333.    * examples: basic speech recognition example programs
  1334.  
  1335. * software tools:
  1336.  
  1337.    * DSOsecurity: DSO Function Authentication demos protecting DSO calls
  1338.      from interception or replacement
  1339.    * libdmalloc: debugging malloc lib useful for finding memory corruption,
  1340.      uses DSOs to plug in a different malloc library
  1341.    * Dwarf: src + doc files for DWARF, a binary debugging-information-format
  1342.    * Delta C++: The Silicon Graphics Delta C++ Compiler White Paper,
  1343.      (Preliminary, 18 pgs), new C++ compiler supports C++ shared lib
  1344.      evolution and speeds up build process
  1345.    * syms: script lists exported functions in libs, and as "undef" to ensure
  1346.      all unresolved symbols are accounted for
  1347.    * inst: one-stop-shop Silicon Graphics software directory at top-of-tree
  1348.      with links to all Silicon Graphics DT inst-images
  1349.    * crpt: script that generates a kernel core file report
  1350.    * MMmalloc: a new libmalloc, faster, better memory utilization with
  1351.      recycle
  1352.    * technical review of The Annotated ANSI C Standard + ANSI C rationale
  1353.      text
  1354.    * DSO subtree: 1993 forum slides + 8 case studies + example program
  1355.      demonstrating implementation and use of a DSO
  1356.    * Compilers "Question-and-Answer" file snarfed from
  1357.      external/internal-to-Silicon Graphics news groups
  1358.    * traceback: two progs providing alternate implementations of a function
  1359.      printing a stack traceback of the calling program
  1360.    * gencall: generates a high-level programming interface to the MIPS«
  1361.      calling convention on Silicon Graphics machines
  1362.    * dbcopy: a faster version of the memory copy routines than is found in
  1363.      libc in 5.1 and before
  1364.    * trubasic: the True BASIC programming language with a 250-line limit on
  1365.      progs which can be run with little or no modification on Macs and PCs
  1366.    * 64-bit documents in PostScript:
  1367.         o Preparing for the 64 bit Future of IRIX
  1368.         o Native 64-bit Subprogram Interface for MIPS Architectures
  1369.         o 64-bit C Porting Guide
  1370.         o 64-bit C and Fortran variable sizes file
  1371.  
  1372. * Silicon Studio(TM):
  1373.  
  1374.    * Creative Destinations, Silicon Studio(TM) Training Centers describes
  1375.      eight locations in Europe and North America and what they each offer
  1376.    * Silicon Studio(TM) Technical Report covering video and compression
  1377.      products including Gailieo Video, Indy(TM) Video, Indigo▓ Video, Cosmo
  1378.      Compress(TM), and Sirius Video(TM)
  1379.    * The Silicon Studio for Publishing Environment from Silicon Graphics
  1380.  
  1381. * printers:
  1382.  
  1383.    * May, 1994 list of ALL printers and scanners supported by Silicon
  1384.      Graphics w/notes including which are supported by Impressario
  1385.    * lpr: a script enabling default lp printing to be dumped to lpr(1)
  1386.    * ps_fonts: programs check whether PS device allows printing of all
  1387.      characters
  1388.  
  1389. * FAQs:
  1390.  
  1391.    * Frequently Asked Questions--13 Silicon Graphics specific, 29
  1392.      general--file listings in subtree at top-of-tree
  1393.  
  1394. * games:
  1395.  
  1396.    * IndiZone games binaries: blackbox, pods, and sb (Space Boulders), and
  1397.      Tom Benoist's classic solitaire game, klondike
  1398.    * source for three IndiZone I games: portfolio, and sw (Spacewar)
  1399.    * IndiZone II games source code: blix, cycles, gold, tagh, vroom
  1400.    * source for Silicon Graphics classic "buzzwordBingo," cubetris, and
  1401.      seahaven games
  1402.  
  1403. * exampleCode:
  1404.  
  1405.    * smoke: Texture Mapped `smoke' special F/X implementation +
  1406.      documentation
  1407.    * stereo: src for 5.2 IRIS GL software-stereo-in-a-window or "SoftStereo"
  1408.    * I18N: examples of internationalization and localization with
  1409.      implementation of wide characters for string manipulation & XPG/3 and
  1410.      MNLS message cataloging
  1411.    * Inventor: src/documentation/data files and full-function scientific
  1412.      calculator plus additional Inventor Nodes and audio and Inventor
  1413.      Classes
  1414.    * buffer: GLX mixed model Motif double-buffered overlay program
  1415.    * texvol: performs volume rendering using 2D or 3D textures
  1416.    * littleRedCap: an Xlib GLX mixed model interface checking and capping
  1417.      demo
  1418.    * GLX: example implementations of (4.0) mixed model programming
  1419.    * dualhead: GLX example code illustrates basics of writing code taking
  1420.      advantage of multiple screens
  1421.    * SciTex: a paper and example code describing Texture Mapping in
  1422.      Technical, Scientific and Engineering Visualization
  1423.    * gameOfLife: example implementation using the stencil planes
  1424.    * fconv: Motif-based numeric format conversion utility for hex, octal and
  1425.      decimal equivalents
  1426.    * 3Dmodeling: routines (and example programs) to help build solid models
  1427.    * cap: IRIS GL demo of a technique to "cap" clipped (cut-away) solid
  1428.      object
  1429.    * calc: IRIS GL implementation of a Reverse Polish Notation calculator
  1430.    * swirl: IRIS GL texture generator program for texture maps
  1431.    * csg: example src and paper on constructive solid geometry
  1432.    * outline and stencil: programs implementing drawing in the stencil
  1433.      planes
  1434.  
  1435. * demos:
  1436.  
  1437.    * source code for 47 SGI demos:
  1438.         o OpenGL based: atlantis, backtrace, drip, fadeflip, globe,
  1439.           glutduck, ideas, insect, lorenz, puzzle, stonehenge, tex_cube,
  1440.           walker
  1441.         o IRIX 4 GLX-based video: specialfx, vidtmesh, vidpaint, trails,
  1442.           bigvideoin
  1443.         o general IRIS GL: atlantis, bounce, buttonfly, closeup, curve,
  1444.           demograph, dragon, flight, flip, ideas, logo, newave, newton,
  1445.           rotimg, snoop, snurb
  1446.         o VGX-intended: blob, envmap, morph, shadows
  1447.         o audio: amesh, bz, drive, synthia
  1448.         o RealityEngine intended: atom, distort, fastshadows, and weather
  1449.  
  1450. * binaries:
  1451.  
  1452.    * fsn -- File System Navigator now reads relative paths Check out fsn as
  1453.      an alternative to visually scanning the Toolbox tree
  1454.    * inout+backat: groupware progs establish an In/Out board on a local
  1455.      network
  1456.    * tiepoint: demos use of Control|Tie points to determine coefficients of
  1457.      a polynomial warping function
  1458.  
  1459. * Multi Processor implementations:
  1460.  
  1461.    * MP: subtree for parallel programming applications issues, includes how
  1462.      to combine mips1 & mips2 objects into a single mips1/2 executable thru
  1463.      a jump table implementation, and a using a high resolution timer of the
  1464.      io3 board on an r4k-based Silicon Graphics system
  1465.  
  1466. AND, other TOP-OF-TREE ASCII text information files besides this one:
  1467.  
  1468.        ALL DTa-z* files have a .html form superior to the following;
  1469.             the .txt format is included for access-versatility.
  1470.  
  1471. DTa-zAudio.txt:    DT sound files listed by directory
  1472. DTa-zDocs.txt:     documents listed by title
  1473. DTa-zIV.txt:       Inventor .iv data files listed by directory
  1474. DTa-zImgsGIF.txt:  gif images (so many, so listed separately)
  1475. DTa-zImgsJPG.txt:  jpg images (so many, so listed separately)
  1476. DTa-zImgsRGB.txt:  rgb images (so many, so listed separately)
  1477. DTa-zImgsTIF.txt:  tif images (so many, so listed separately)
  1478. DTa-zImgHaeb.txt:  images in src/haeberli listing (info "richer")
  1479. DTa-zInst.txt:     inst images listed by directory
  1480. DTa-zLibs.txt:     library archives and DSOs listed alphabetically
  1481. DTa-zSrc.txt:      DT binaries listed alfabetically w/path-location
  1482.  
  1483. DThelp.txt:        Help topics relevant to the operation of the v6.1 CD
  1484. README:            this file in boring ascii text form
  1485.  
  1486. Makefile.README:   IRIX 5 gotcha's as far as MAKE(1) is concerned
  1487. README.Inventor:   how to compile with Open Inventor 2.0 and
  1488.                      Inventor 1.1.2 libs + hdrs on the same machine
  1489. sifttree.README:   how to do multiple keyword/filename searches
  1490.  
  1491.            ------------------------------------------------------
  1492.  
  1493.      After sampling the software, you may want to copy some or all of
  1494.      the code from the CDROM to your workstation. Although you may copy
  1495.      the software to any disk with enough space, it is intended to be
  1496.      copied into the "/usr/people/4Dgifts/toolbox" directory. Local
  1497.      Makefiles are provided for all source code.
  1498.  
  1499.      Total size of the v6.1 DT is approximately 614+ megabytes on CD 0,
  1500.           596+ megabytes on the CD 1, and 594+ megabytes on CD 2.
  1501.  
  1502. ----------------------------------------------------------------------------
  1503.  
  1504.      Please find below the contents of the viewDT helpfile
  1505.      (/CDROM/bin/helpfile) and the dtCDmgr internal helpfile as of
  1506.      September 25, 1996. The helpfile available via the "Help" button
  1507.      in the viewDT window will be more current than this version.
  1508.  
  1509. ----------------------------------------------------------------------------
  1510.                start of viewDT helpfile (/CDROM/bin/helpfile)
  1511.  
  1512.      The purpose of this "help" file is to provide information about
  1513.      initiating viewing of the v6.1 CD form of the Developer Toolbox.
  1514.      Areas discussed are:
  1515.  
  1516.           0) if your CDROM drive is not mounted as /CDROM
  1517.           1) location of Developer Toolbox "help" documentation
  1518.           2) prerequisites to satisfy before starting any viewing
  1519.           3) how to do the viewing
  1520.           4) essential information about the viewing process
  1521.           5) files placed on your workstation while running viewDT
  1522.  
  1523.      0) if your CDROM drive is not mounted as /CDROM
  1524.      -------------------------------------------
  1525.  
  1526.           Throughout this document we presume you have the DT CD
  1527.           mounted as /CDROM. Some sites will choose to mount the CDROM
  1528.           drive elsewhere, or will have more than one CDROM drive. You
  1529.           will need to know what your system's directory name is, if it
  1530.           is other than /CDROM, and employ it accordingly in your use
  1531.           of these instructions. The most direct way to ascertain under
  1532.           what directory name the CDROM device is mounted as is to run
  1533.           the following command in a shell window:
  1534.  
  1535.                % more /etc/fsd.tab
  1536.  
  1537.           For example, the /etc/fsd.tab file of the system on which
  1538.           these notes were written contains the following:
  1539.  
  1540.      /dev/dsk/dks0d4s7 /CDROM efs ro,sock=/tmp/.mediadXXXXXX 0 0
  1541.      /dev/rmt/tps0d5nr /tape archive opts=NA,sock=/tmp/.mediadXXXXXX 0 0
  1542.  
  1543.           If you don't see the string "CDROM," the most commonly
  1544.           employed alternative name is "cdrom." You will need to
  1545.           substitute our use of "CDROM" in command sequences below,
  1546.           with whatever your system is using as "CDROM".
  1547.  
  1548.      1) location of Developer Toolbox "help" documentation
  1549.      ---------------------------------------------
  1550.  
  1551.           A printed version of this file is the actual liner notes of
  1552.           the Developer Toolbox CDs. It is the oldest and most out of
  1553.           date version of the information. The CDs have the next most
  1554.           current version of this file. It is on all DT CDs in
  1555.           /CDROM/bin/helpfile. Also on each CD, is a superset of this
  1556.           file that describes this and other helpful information
  1557.           regarding use of the Toolbox. It is located via the Help
  1558.           button (with the image of a hawk) on the TOP/HUB entry page
  1559.           of the Toolbox (a text only version of this
  1560.           /CDROM/toolbox/DThelp.html file is to be found in
  1561.           /CDROM/toolbox/DThelp.txt). As is typical, the CD version of
  1562.           this file is a snapshot of the live one found via the
  1563.           https://www.sgi.com/toolbox/ secure web house URL. Don't
  1564.           confuse the Help pull-down menu in the upper-right corner of
  1565.           the Netscape browser window, with our "Help" icon button. The
  1566.           browser pull-down menu will take you to information about
  1567.           Netscape itself.
  1568.  
  1569.      2) prerequisites to satisfy before starting any viewing
  1570.      -------------------------------------------
  1571.  
  1572.           There are some prequisites you will want to ensure are
  1573.           satisfied before you attempt to view anything on the
  1574.           Developer Toolbox. There are two versions of the following
  1575.           information: one for people on a system running IRIX 6.2, and
  1576.           the other for people running IRIX 5.3 (or anything else prior
  1577.           to IRIX 6.2).
  1578.  
  1579.        A. For people running viewDT on an IRIX 6.2 system:
  1580.  
  1581.             i. Make sure you have all the Netscape helper programs
  1582.                installed.
  1583.  
  1584.                You can verify you have IRIX 6.2-released versions of
  1585.                the following subsystems containing the necessary
  1586.                netscape helper apps by running the versions command and
  1587.                comparing the described version numbers to the
  1588.                following:
  1589.  
  1590.                   + showcase -- IRIS Showcase 3.4
  1591.                          showcase.sw.showcase
  1592.                   + inventor_eoe -- Inventor Execution Only
  1593.                     Environment, 2.1.2
  1594.                          inventor_eoe.sw.2_0
  1595.                   + imgtools -- ImageVision Tools, 3.0
  1596.                          imgtools.sw.tools
  1597.                   + il_eoe -- ImageVision Library Execution Only
  1598.                     Environment, 2.5.1
  1599.                          il_eoe.sw.c++
  1600.                          il_eoe.sw.tiff
  1601.                          il_eoe.sw.sgi
  1602.                          il_eoe.sw.jfif
  1603.                          il_eoe.sw.gif
  1604.                   + dmedia_eoe -- IRIS Digital Media Execution
  1605.                     Environment, 6.2
  1606.                          dmedia_eoe.sw.audio
  1607.                          dmedia_eoe.sw.common
  1608.                          dmedia_eoe.sw.lib
  1609.                          dmedia_eoe.sw.soundscheme
  1610.                          dmedia_eoe.sw.midi
  1611.                          dmedia_eoe.sw.tools
  1612.                          dmedia_eoe.sw.video
  1613.                   + dps_eoe -- Display PostScript/X, 2.0.5 based on
  1614.                     PostScript Level 2
  1615.                          dps_eoe.sw.dps
  1616.                     This subsystem is not needed for people who use
  1617.                     something other than xpsview(1) to view PostScript
  1618.                     files on their system. You can arrange to use a
  1619.                     different PostScript viewer via your personal
  1620.                     $HOME/.mailcap file and an appropriate substitute
  1621.                     helper program (e.g. ghostview).
  1622.                     It is worth mentioning that if you do not have your
  1623.                     own $HOME/.mailcap and/or $HOME/.mime.types files,
  1624.                     versions of these will be created for you.
  1625.                     $HOME/.mime.types is used to augment the global
  1626.                     default definitions
  1627.                     (/usr/local/lib/netscape/mime.types) of the file
  1628.                     extensions which correspond to a particular mime
  1629.                     type. $HOME/.mailcap is used to augment the global
  1630.                     default definitions
  1631.                     (/usr/local/lib/netscape/mailcap) of the mime types
  1632.                     which correspond to a particular helper
  1633.                     application. There will be some Toolbox-specific
  1634.                     definitions added to both of these files to help
  1635.                     support the viewing of Developer Toolbox content.
  1636.  
  1637.        B. For people running viewDT on an IRIX 5.3 (i.e. a non IRIX
  1638.           6.2) system.
  1639.  
  1640.             i. Make sure you have all the Netscape helper programs
  1641.                installed.
  1642.                (Available on the Descktop Special Edition (DSE) 1.1 CD)
  1643.  
  1644.                You can verify you have sufficiently current versions of
  1645.                the following subsystems containing the necessary
  1646.                netscape helper apps by running the versions command and
  1647.                comparing the described version numbers to the
  1648.                following:
  1649.  
  1650.                   + showcase -- IRIS Showcase 3.3.3
  1651.                          showcase.sw.showcase
  1652.                   + inventor_eoe -- Inventor Execution Only
  1653.                     Environment, 2.1.1
  1654.                          inventor_eoe.sw.inventor
  1655.                   + imgtools -- ImageVision Tools, 2.3
  1656.                          imgtools.sw.tools
  1657.                   + il_eoe -- ImageVision Library Execution Only
  1658.                     Environment, 2.5
  1659.                          il_eoe.sw.c++
  1660.                   + dmedia_tools -- IRIS Digital Media Tools, 5.5
  1661.                          dmedia_tools.sw.movietools
  1662.                          dmedia_tools.sw.soundtools
  1663.                   + dmedia_eoe -- IRIS Digital Media Execution
  1664.                     Environment, 5.5
  1665.                          dmedia_eoe.sw.audio
  1666.  
  1667.                If you do not have the above subsystems loaded, you can
  1668.                find them on the DSE 1.1 CD, the second CD included in
  1669.                the v5.1 DT. It contains all the inst images needed to
  1670.                satisfy the above prerequisites.
  1671.  
  1672.                If you do not have the v5.1 DT, look for a copy of the
  1673.                DSE 1.1 CD with your collection of IRIX 5.3 CDs. If it
  1674.                is not there, you can also access the DSE 1.1 contents
  1675.                at https://www.sgi.com/toolbox/DSE1.1/. If you are
  1676.                unable to do this, contact the Developer Program at
  1677.                devprogram@sgi.com, or on the phone either via
  1678.                1-800/770-3033, or 415/933-3033, or by fax via
  1679.                415/969-6327, and tell them you need a copy of the DSE
  1680.                1.1 CD sent to you through the post.
  1681.  
  1682.            ii. Make sure you have all the appropriate patches
  1683.                installed.
  1684.  
  1685.                Not all subsystems in these patches will install -- you
  1686.                will only be allowed to install subsystems corresponding
  1687.                to base software already installed. In other words,
  1688.                always attempt to install the entire patch and don't be
  1689.                alarmed about the parts which do not install.
  1690.  
  1691.                Some of the patch locations mentioned below also contain
  1692.                a recommended patch list. It is helpful to know your
  1693.                hardware and O.S. level in order to install the
  1694.                recommended patches. We are working to have this
  1695.                information included in the toolbox. We do have an
  1696.                abbreviated list below of seven key patches for IRIX
  1697.                5.3, current as of August 14, 1996. All of them are
  1698.                replacements of similar IRIX 5.3 patches recommended in
  1699.                the v5.1 DT. These patches are also available on the
  1700.                toolbox in /toolbox/dist/5.3/patches/
  1701.  
  1702.                Patch 1412 - IRIX 5.3 Networking Rollup Patch
  1703.                     3MBs 8/13/96
  1704.                Patch 1268 - 5.3/5.3xfs combined kernel rollup patch
  1705.                     8MBs 6/6/96
  1706.                Patch 1264 - XFS rollup patch for 5.3
  1707.                     30MBs 5/1/96
  1708.                Patch 1102 - NFS roll up
  1709.                     2MBs 4/3/96
  1710.                Patch 1095 - Scrolled Window patch
  1711.                     2MBs 1/19/96
  1712.                X server roll up Choose at most one of the following
  1713.                     Patch 1187 - excluding Impact graphics (for
  1714.                     non-Impact systems)
  1715.                          14MBs 3/22/96
  1716.                     Patch 1271 - only for Impact graphics (for Impact
  1717.                     systems)
  1718.                          2MBs 5/1/96
  1719.  
  1720.                For those people with support contracts these patches
  1721.                are available in the Support Folio quarterly release
  1722.                CDs, and also inside Silicon Surf's SurfZone (to
  1723.                register, go to http://www.sgi.com/Misc/zone.html), in
  1724.                Supportfolio Online's "Silicon Graphics's support
  1725.                patches on the web" entry page.
  1726.  
  1727.           iii. Possible Inst Warning Messages and Conflicts:
  1728.  
  1729.                There are two different types of warning messages you
  1730.                might see which are benign. When you run the inst
  1731.                command "keep Same" as part of the prerequisite install
  1732.                sequence, you might see the warning message "No matches
  1733.                were found." You can safely ignore it.
  1734.  
  1735.                After running the inst command "go," you might see some
  1736.                conflicts concerning subsystems not presently installed
  1737.                on your system. These should offer a single resolution
  1738.                to the conflict. The choice will be to not install a
  1739.                particular patch subsystem. It is quite safe to select
  1740.                this single choice resolution to the conflict.
  1741.  
  1742.                Rhere is one error condition which might occur which
  1743.                will require some work on your part. In a shell window,
  1744.                run the command "versions tooltalk_eoe". If you see the
  1745.                subsystems "tooltalk_eoe.sw.links" and
  1746.                "tooltalk_eoe.sw.runtime" listed, there is nothing more
  1747.                to do. Otherwise, before performing the prerequisite
  1748.                install sequence, you must locate your "IRIX 5.3" CD and
  1749.                install the two tooltalk_eoe subsytems mentioned above.
  1750.                If for some reason you are unable to install these
  1751.                subsytems, then you will be unable to view the only two
  1752.                movies which are present on the Developer Toolbox v6.1
  1753.                CD.
  1754.  
  1755.            iv. A PostScript Viewing Issue:
  1756.  
  1757.                You will have nothing more to do, if you have already
  1758.                installed the 5.3 subsystem, dps_eoe.sw.dps, which
  1759.                provides the Netscape viewer application xpsview.
  1760.                Without this subsystem you will not be able to view
  1761.                PostScript files on the Developer Toolbox. Of course,
  1762.                you can arrange to use a different viewing program via
  1763.                your personal $HOME/.mailcap file and an appropriate
  1764.                substitute helper program.
  1765.  
  1766.                It is worth mentioning that if you do not have your own
  1767.                $HOME/.mailcap and/or $HOME/.mime.types files, versions
  1768.                of these will be created for you. $HOME/.mime.types is
  1769.                used to augment the global default definitions
  1770.                (/usr/local/lib/netscape/mime.types) of the file
  1771.                extensions which correspond to a particular mime type.
  1772.                $HOME/.mailcap is used to augment the global default
  1773.                definitions (/usr/local/lib/netscape/mailcap) of the
  1774.                mime types which correspond to a particular helper
  1775.                application. There will be some Toolbox-specific
  1776.                definitions added to both of these files to help support
  1777.                the viewing of Developer Toolbox content.
  1778.  
  1779.      3) how to do the viewing
  1780.      --------------------
  1781.  
  1782.           To view the Developer Toolbox, simply type the following
  1783.           command:
  1784.  
  1785.                % /CDROM/bin/viewDT
  1786.  
  1787.           Move the cursor into the Toolbox window which pops up. Now
  1788.           press the "Enter" key on your keyboard. This command will
  1789.           copy about 10 megabytes of Developer Toolbox viewing
  1790.           utilities to your local disk, if they have not already been
  1791.           placed there by a previous viewDT session. The Developer
  1792.           Toolbox viewing utilities will be upgraded with a newer
  1793.           version, if one is found on the CD. Specifically, to the
  1794.           directory /usr/tmp, unless the environment variable TMPDIR is
  1795.           defined. The next time you run, the command will not need to
  1796.           recopy this data. Although we recommend you keep this data
  1797.           local, you can elect to have it removed by running the
  1798.           command "viewDT -r" rather than "viewDT". If you would prefer
  1799.           to have the 10 Meg stored in a different directory you can
  1800.           also do this by running the command "viewDT -f
  1801.           <new_directory>" instead of "viewDT"
  1802.  
  1803.           There are several modes in which viewDT can be run:
  1804.  
  1805.           viewDT [-r] [-f tmp_dir] [-C CD_dir]
  1806.                This is the standard mode outlined above, with one
  1807.                exception. The -C option allows viewDT to be run from
  1808.                the DT_utilities directory rather than from a DT CD. In
  1809.                fact, the -C option must be used when running from the
  1810.                DT_utilities directory. You might need to do this when
  1811.                using a more advanced version of the DT_utilities with
  1812.                an older CD version of the Developer Toolbox. Such a
  1813.                condition does not currently exist.
  1814.           viewDT -u [-f tmp_dir]
  1815.                This version of the command is used to just create the
  1816.                DT_utilities directory. It is most often used as one of
  1817.                the steps used to install a fixDT patch for a particular
  1818.                DT CD. The -f option is only needed when the
  1819.                DT_utilities directory should be placed in a particular
  1820.                directory.
  1821.           viewDT -R [-f tmp_dir]
  1822.                This version of the command is used to just remove the
  1823.                DT_utilities directory. The -f option is only needed
  1824.                when the DT_utilities directory exists in a non-standard
  1825.                directory.
  1826.  
  1827.      4) essential information about the viewing process
  1828.      -----------------------------------------
  1829.  
  1830.           There is some essential information which will help you
  1831.           manage your workstation resources and your time as you view
  1832.           and use the Developer Toolbox CD.
  1833.  
  1834.              o First off, activating the "Help" button produces this
  1835.                help file, which you probably already know since you are
  1836.                reading this.
  1837.  
  1838.              o You may see a Netscape "Question" window informing you
  1839.                of a Netscape lock file. You will see this if you have
  1840.                Netscape running in another window. If you do not care
  1841.                if you will be unable to save bookmarks and other
  1842.                history in this new window then just click "OK".
  1843.                Otherwise, click "Cancel", close the other Netscape
  1844.                window and reselect "View".
  1845.  
  1846.              o If you are not connected to the Web and the Internet,
  1847.                then there are a number of Toolbox features you will not
  1848.                be able to access. Specifically, Web references to
  1849.                places outside of the Developer Toolbox CD and the
  1850.                pheedback mechanism.
  1851.  
  1852.              o The first time you access or follow a link to a place
  1853.                not on the current CD, the utility dtCDmgr will be run.
  1854.                It will allow you to specify how to mount the needed CD
  1855.                and any other CDs which will also be needed. The
  1856.                helpfile for dtCDmgr appears below.
  1857.  
  1858.              o When the Toolbox window is present, it shows the server
  1859.                status of both the "http" server, the web server, as
  1860.                well as the "oksvr" server, the server for the search
  1861.                engine. It takes time for the two servers to be started.
  1862.  
  1863.              o There are a separate pair of servers created for each
  1864.                user viewing the CD. It is literally your own personal
  1865.                web site. You may want to keep these servers running if
  1866.                you plan to periodically access the Toolbox. The way to
  1867.                do this is to not "Quit" from the Toolbox window, but
  1868.                simply leave the window running on your console either
  1869.                in its opened form or stowed as an icon.
  1870.  
  1871.              o Activating the "View" button for the first time starts
  1872.                up the httpd and oksvr servers and then starts up
  1873.                netscape. Upon exiting the Netscape window, the little
  1874.                Toolbox window returns to your console screen.
  1875.                Subsequent activations of the "View" button simply
  1876.                invokes netscape again, since the two servers are
  1877.                already running.
  1878.  
  1879.              o When you have quit/exited from the Netscape window, and
  1880.                the little Toolbox window has returned, you will see the
  1881.                "running" status of the two servers displayed and their
  1882.                respective port numbers.
  1883.  
  1884.              o Netscape is fairly consumptive of memory, so you may
  1885.                want to exit from netscape, leaving the servers running.
  1886.                Unlike netscape, the servers consume very little memory.
  1887.                The binary filename for the http server is
  1888.                "dt_httpd.exe". The binary filename for the oksvr server
  1889.                is "dt_oksvr". These have both been renamed to avoid
  1890.                confusion with any httpd/oksvr executables already
  1891.                running on your system. A helpful way to see how much
  1892.                memory netscape is currently using is with the gmemsuage
  1893.                program, the graphical memory usage display tool
  1894.                included on the DT.
  1895.  
  1896.      5) files placed on your workstation while running viewDT
  1897.      -----------------------------------------------
  1898.  
  1899.           Files are placed on your workstation to support the running
  1900.           of the two servers.
  1901.  
  1902.           If you don't already have $HOME/.netscape-preferences,
  1903.           $HOME/.mime.types, and/or $HOME/.mailcap files, then
  1904.           instances will be created for you. You are likely to already
  1905.           have these files if you run Netscape or some other web
  1906.           viewer. These three files are the only files created by
  1907.           viewDT which persist after you quit from it. Additionally,
  1908.           the files $HOME/.mime.types and $HOME/.mailcap have some
  1909.           lines needed to correctly view certain types of files on the
  1910.           Toolbox. In both files you will see a comment line of the
  1911.           form "#--TOOLBOX_Compliant_File----". Please do not remove
  1912.           these lines. They mark your files as having the necessary
  1913.           definitions present. Just after this line will be the
  1914.           definitions bounded by comment lines of the form
  1915.           "#--TOOLBOX_SPECIFIC_THINGS".
  1916.  
  1917.           In the $HOME directory, you will find the file .dtcdresource.
  1918.           It contains a list of the CDROM drives and/or directories
  1919.           where dtCDmgr has been directed to find DT CDs. This file is
  1920.           used to save the user from re-specifying these locations
  1921.           every time viewDT is invoked.
  1922.  
  1923.           In the /tmp directory, you will find two files (described
  1924.           below) for each user. These files only exist while the viewDT
  1925.           is running. The <n> at the end of their file name,
  1926.           corresponds to the port number of the httpd server for those
  1927.           files. For instance, .cdlocation_8080 corresponds to the
  1928.           mount point of the CDROM for the httpd server listening to
  1929.           port 8080.
  1930.  
  1931.           In the /tmp directory, you may find the directory .portlock.
  1932.           It is used when searching for free ports from which to run
  1933.           the httpd and oksvr. There is the possibility an unexpected
  1934.           error will fail to remove this directory, which must then be
  1935.           removed manually.
  1936.              o .cdlocation_<n> - which defines the mount point of the
  1937.                CDROM.
  1938.              o .userhome_<n> - which defines the absolute path location
  1939.                of your $HOME directory.
  1940.  
  1941.           The $HOME/.www directory is a transitory directory. It only
  1942.           exists while viewDT is running. In it, you will find several
  1943.           files and directories:
  1944.              o .DT_DocRootFile - a file used by Developer Toolbox
  1945.                cgi-bin scripts to point to the Developer Toolbox
  1946.                document root. In our case, it points to
  1947.                $HOME/.www/htdocs.
  1948.              o .DT_OksvrRoot - a file used by Developer Toolbox cgi-bin
  1949.                scripts to point to the Developer Toolbox searchtools
  1950.                directory. In our case, it points to
  1951.                $HOME/.www/htdocs/toolbox/searchtools.
  1952.              o cgi-bin - a link to the Toolbox cgi-bin directory
  1953.                <DT_utilities>//cgi-bin/
  1954.              o conf - the directory of configuration files for your
  1955.                Toolbox web-on-a-CD.
  1956.              o htdocs - the Document Root of your Toolbox web-on-a-CD.
  1957.              o icons - a link to the directory <DT_utilities>/icons/
  1958.                . It is the directory of the standard X bitmap icons.
  1959.              o logs - log directory of your Toolbox web-on-a-CD.
  1960.                It contains the access_log, agent_log, error_log, and
  1961.                referer_log log files. It also contains the port numbers
  1962.                of the httpd server and the oksvr server in the
  1963.                httpd.port and oksrv.port files. It contains the process
  1964.                ID of the httpd server in the httpd.pid file.
  1965.  
  1966.                 end of viewDT helpfile (/CDROM/bin/helpfile)
  1967. ----------------------------------------------------------------------------
  1968.  
  1969. ----------------------------------------------------------------------------
  1970.                          start of dtCDmgr helpfile
  1971.  
  1972.                       How to use the Developer Toolbox
  1973.                      Distributed CDROM Resource Manager
  1974.  
  1975. To EJECT Your Currently Loaded CD:
  1976.  
  1977.   1. press LEFTMOUSE on the CD listed in the body of the dtCDmgr window (to
  1978.      select it)
  1979.   2. press the "Eject" button (second from left at bottom of window)
  1980.      NOTE: If the eject fails you will have to do the following:
  1981.         o In a shell window, become super user ("su -")
  1982.         o Run the command "umount -k <device>", where <device> is the drive
  1983.           you want to eject (e.g. execute "umount -k /CDROM" to free up the
  1984.           CDROM drive device). Be aware: this will kill any processes using
  1985.           this device. As long as this is only the DT, you'll be OK.
  1986.         o After running umount, repeat step 2 (the single-line) above, and
  1987.           continue.
  1988.   3. replace the CD with the one for which you are being prompted
  1989.   4. make sure the same CD device is selected (press LEFTMOUSE if necessary)
  1990.   5. in the "Edit" pull-down menu, choose the "Refresh" menu item
  1991.   6. press the "Done" button (button at bottom right-corner of window).
  1992.  
  1993. dtCDmgr orientation
  1994.  
  1995. You probably started up this utility, dtCDmgr, by trying to go to an
  1996. unmounted link. This is the most typical way to start it. You can also start
  1997. dtCDmgr by hand in the same way you started up viewDT, but viewDT must
  1998. already be running before you invoke dtCDmgr. For instance, if you started
  1999. viewDT by typing "/CDROM/bin/viewDT", you can then start dtCDmgr after
  2000. viewDT is already running by typing "/CDROM/bin/dtCDmgr".
  2001.  
  2002. Use the dtCDmgr utility to manage local and remote CDROMs for your Developer
  2003. Toolbox CD datasets. For example, you can load the first CD in your local
  2004. CDROM drive and the second and third CDs in remote drives. Use the "Add..."
  2005. button to add local and remote CDROM mount points (paths) that you use to
  2006. access the other CDs and the information on them.
  2007.  
  2008. NOTE: If you only have one CDROM drive, you must first eject your currently
  2009. loaded CD and then insert the CD for which you are being prompted. To do
  2010. this, select the CD shown in the dtCDmgr window with LEFTMOUSE. This will
  2011. make the Eject button come alive. Press Eject and then switch CDs. Then
  2012. using the Edit pull-down menu, select "Refresh" to have the dtCDmgr
  2013. recognize the CD you have inserted. The final step then is to press the
  2014. "Done" button.
  2015.  
  2016. NOTE: Automount must be running in order to access remote-mounted CDROMs. If
  2017. you are not familiar with this, see the AUTOMOUNT(1M) man page for more
  2018. information.
  2019.  
  2020. The remote CDROM paths are specified as follows:
  2021.  
  2022.      /hosts/hostname/cddirname
  2023.  
  2024. where:
  2025.  
  2026.      hosts is the actual name of the subdirectory in the root directory
  2027.      hostname is the name of the remote machine
  2028.      cddirname is the path of a mounted CDROM
  2029.  
  2030. for example, /hosts/rocinante.engr/CDROM
  2031.  
  2032. Important Files
  2033.  
  2034. $(HOME)/.www_6.1 is the temporary directory used by the viewDT command.
  2035. $(HOME)/.dtcdresource contains the pathnames of the local and remote CDROMs
  2036. you configure and from which the dtCDmgr utility reads.
  2037.  
  2038. User Interface
  2039.  
  2040.      Using the Display Region
  2041.  
  2042.      The display region is the bulk of the dtCDmgr window listing the
  2043.      currently mounted CD(s). For example if you started by loading CD 0 in
  2044.      your local CDROM drive, you will see one line in the dtCDmgr display
  2045.      region that reads,
  2046.  
  2047.           [purple CDicon image] Developer Toolbox v6.1, CD 0 (/CDROM/)
  2048.  
  2049.      To select an entry from the display region, use the left mouse button
  2050.      to click on it. Clicking on the line a second time will deselect it.
  2051.      Selected entries are highlighted in dark red. See "Using the Pull-Down
  2052.      Menus" section below for a descrition of the operations possible to
  2053.      perform on selected entries.
  2054.  
  2055.      The display region in the center of the dtCDmgr utility lists the CD(s)
  2056.      and CDROM-drive(s) currently know to the dtCDmgr. Entries consist of a
  2057.      CD icon, a CD title, and a pathname. The CD title will only appear if
  2058.      the pathname points to a recognized mounted SGI CD.
  2059.  
  2060.      There are four distinct CD icons:
  2061.  
  2062.         o A filled icon represents a CDROM that is loaded.
  2063.         o An unfilled icon represents an empty CDROM drive.
  2064.         o A purple filled icon means it is a recognized SGI CD.
  2065.         o A circle with a lightning bolt represents an invalid path.
  2066.  
  2067.      Using the Buttons
  2068.  
  2069.      There are four different buttons appearing at the bottom of the GUI:
  2070.  
  2071.            Add...    To add a absolute pathname for a CDROM.
  2072.                      The CD title is read from the CD. Do not attempt to add
  2073.                      it.
  2074.            Eject     To eject the selected entry or entries.
  2075.            Cancel    To quit without updating the resource file.
  2076.            Done      To update the resource file and quit.
  2077.  
  2078.      Using the Pull-Down Menus
  2079.  
  2080.         o To update the resource file and quit, choose "Exit" from the File
  2081.           pull-down menu (this has the same effect as using the "Done"
  2082.           button).
  2083.         o To remove selected entries from the display region, choose "Delete
  2084.           Selected" from the Edit pull-down menu.
  2085.         o To modify a selected entry, choose "Edit Selected..." from the
  2086.           Edit pull-down menu.
  2087.         o To update the status of all currently mounted CDs, choose
  2088.           "Refresh" from the Edit pull-down menu.
  2089.  
  2090. Troubleshooting
  2091.  
  2092. If a CDROM device is busy, you cannot eject a CD. Make sure no other program
  2093. is using a file on the CDROM. For instance, one might be editing a file of
  2094. the CD, or running a program from the CD, etc. Also, in any shell or dirview
  2095. window, do not let your current working directory be any directory under
  2096. /CDROM. If you cannot eject a CD using the dtCDmgr utility, try a hardware
  2097. eject (pressing the eject button on the CDROM drive), or use the fuser(1M)
  2098. command, for example:
  2099.  
  2100.      fuser -cu /CDROM
  2101.  
  2102. to find out who else is using the CD. Note the state change of the desktop
  2103. CDROM icon, when you load or eject a CD.
  2104.  
  2105.                           end of dtCDmgr helpfile
  2106. ----------------------------------------------------------------------------
  2107.  
  2108. ----------------------------------------------------------------------------
  2109.  
  2110. janitors's corner:
  2111.  
  2112.    this one is going through a particularly bad case of "notimeitis", the
  2113. diagnosis otherwise known as the "i'm too bizi" dis-ease. with numbness in
  2114. the right arm from too much typing, a.k.a. Repetitive Stress Injury (RSI),
  2115. and a ruptured extensor tendon in the left hand's middle finger's outermost
  2116. knuckle, the past months have included the beginnings of attempts to learn
  2117. how to type differently (for the numbness) and the wisdom of the body
  2118. stepping in to regain a missing sense of proportion the mind can so oft be
  2119. led astray by.
  2120.    the major efforts during the period while we endeavored to create v6.1
  2121. was preparing and presenting our toolbox talks at the forum, updating swank
  2122. from 5.3 to 6.2 and then getting everything we could working again by this
  2123. august, as well as documenting what we did, strengthening and extending the
  2124. integrity of the DT serving process, implementing as much of our
  2125. automated-nightly-build mechanism as possible which entails re-imaging the
  2126. internal, external, or CD image trees of the toolbox, re-indexing them and
  2127. testing the integrity of links, and lastly providing support for the sgi
  2128. commerce web server, https://www.sgi.com/. where we could grab extra time we
  2129. collected and integrated new and updated content for the DT.
  2130.    we're very pleezed to have Carsten Koch's CDio Gold Medal software for
  2131. reading and writing audio, efs and iso9660 CD formats. the ReadCD and
  2132. WriteCDR programs add greatly to the DT CD manipulation tools. we had hoped
  2133. to have a much more articulated and explicit message at this juncture
  2134. expressing our interest and desire to promote collaboration between
  2135. ourselves and all of you of which the contribution Carsten has made is the
  2136. most stellar current example. we asked about the level of interest in this
  2137. in the "Your Introduction to the Toolbox" labs at the forum and were pleased
  2138. with the enthusiastic responses. the example of gdiff(1) was mentioned: to
  2139. provide the source on the DT -- since it no longer has an owner in
  2140. engineering and is in fact no longer included on IRIX 6.2 (now replaced with
  2141. xdiff) -- so anyone could take and enhance it with the numerous extensions
  2142. and enhancements it could adopt, then send the changes back to us to
  2143. incorporate into the DT and make this available to everyone else; repeat,
  2144. repeat, repeat, ... obviously this can become a very powerful way to extend
  2145. what we as the janitors can provide on the DT. (unfortunately, it is with
  2146. great regret that, due to historical constraints, we cannot include gdiff's
  2147. source on the DT.) yet one more thing we wanted to do but haven't been able
  2148. to make the time for. see our 18 month out revised-since-the-forum
  2149. TODO-wish-list schedule to get a better sense of all we would like to
  2150. accomplish.
  2151.    it's never felt as "backed-up" as this. a dear friend, who created the
  2152. incredibly unique "i on Visual Computing" (http://www.sgi.com/ion/ -- see
  2153. the excellent Mouse Mauls Man!, fall'95, vol #3, ion article on RSI with
  2154. links to online informational resources) was talking about the pace of
  2155. things: "but you've been doing this for over 10 years -- you're used to it
  2156. -- i've only been in this industry for a year and a half and it's unreal."
  2157. to which i replied, "but it's only been this way since the web kicked in.
  2158. never has there been as much to do to keep things going, to keep things
  2159. `current'". the urge within to do the very best possible while at the same
  2160. time not becoming thrall to the machine at the expense of living has never
  2161. been more challenging. this one's own web haus at http://www.ratical.com/
  2162. has been "on ice" since mid june. leaving that ground fallow has been very
  2163. disheartening. our culture's worship of the intellect, the past participle
  2164. of intelligence, and living life placing the greatest emphasis on thought,
  2165. the response of memory -- of everything we've ever experienced prior to this
  2166. moment -- storing up these memories and calling that knowledge, has
  2167. imprisoned us in an idolization of the rational at the expense of
  2168. instinctual and intuitive awareness and wisdom. we have lost a fertile area
  2169. of our psychic inheritance and seem determined to leave it lost. present and
  2170. accounted for as a birthright at the moment we first breathe, this
  2171. irreplaceably precious universe of understanding and connection is
  2172. shamefully neglected by the preeminence given to thought. the urgent feeling
  2173. for life within grapples with this conundrum. for those who feel any sense
  2174. of affinity with this, i can't recommend strongly enough a story in two
  2175. books that has deeply touched something within more than anything equivalent
  2176. in over 20 years: A Story Like The Wind and A Far Off Place by Laurens van
  2177. der Post.
  2178.  
  2179.         He did what he did instinctively. Yet responsibility for an
  2180.      accurate report on his life forces one to ask oneself something
  2181.      about the nature of this instinct. One wonders whether it was not
  2182.      the process of growth, produced by the urgent feeling for life
  2183.      within himself, hastening to the rescue of an inexperienced and
  2184.      vulnerable nature, in danger of having its evolution arrested,
  2185.      compelling him to concentrate on the growth of things in the world
  2186.      without so that their example would set in motion again growth
  2187.      within himself. World without and world within, after all, whether
  2188.      one knows it or not are expressions of one another; interdependent
  2189.      and ceaselessly in communication, serving something greater than
  2190.      the sum of themselves. They are, however stern and exacting,
  2191.      allies of a questing spirit, particularly a young spirit, charged
  2192.      to join them both in a little garden allotment of space and time.
  2193.      Happy for Francois, therefore, despite the miseries of the moment,
  2194.      that he was free of the mistrust of instinct and intuition wherein
  2195.      contemporary Europe tends to imprison human imagination, and that
  2196.      the pagan influences of his environment encouraged an
  2197.      unquestioning acceptance of this impulse which came to him.
  2198.         A Story Like The Wind, p. 123-4
  2199.  
  2200.           dave@sgi.com         singular
  2201.           DTjanitor@sgi.com     duo
  2202.           415/933-3556     voice-box
  2203.           415/967-6239     fax-me
  2204.           we come to serve.
  2205.           all responses ARE greatly appreciated.
  2206.           swanx for yer interest/participation,
  2207.              dave ratcliffe
  2208.  
  2209.                        -------------------------------
  2210.  
  2211. This toolbox CD cycle has been one of maintenance, for each of us
  2212. personally, as well as with the project as a whole. Creating the DT 6.0 CD
  2213. set pushed it and us to the edge of what is possible. In fact, we/SGI are in
  2214. the process of patenting the multi-CD website mechanism developed for the DT
  2215. v6.0. I've spent a lot of my time making the the mechanism more robust and
  2216. to some extent helping dave with the port of the DT to IRIX 6.2. I've also
  2217. tried to do some mental/physical healing. (Those who know me will
  2218. undoubtably mention mental improvement is not very probable.)
  2219.  
  2220. There are many, many improvements we want to effect to make the website
  2221. better. It just seems we never have the time in which to accomplish all we'd
  2222. like. I/we are still trying to find the balance among performing miracles at
  2223. work, having a life and keeping a life. I've cut back from 14-16 hour days
  2224. to just 10-12 hour days and will have been in three musicals (after a ten
  2225. year break) in a 3 1/2 month period ending mid September. It has been a
  2226. rejuvinating, although tiring, path.
  2227.  
  2228. The divider art we chose is one of sustainable cultivation. It is a reminder
  2229. of both the fundamental nature of the DT v6.1, as well as a current goal to
  2230. weave into the fabric of our lives.
  2231.  
  2232.           murphy@sgi.com
  2233.           DTjanitor@sgi.com (the two of us)
  2234.           415/933-1934 (Voice)
  2235.           415/967-6239 (Fax)
  2236.  
  2237.                     - The object of teaching a child
  2238.                          is to enable him to get along without a teacher.
  2239.  
  2240.                     - The work will teach you how to do it.
  2241.  
  2242.                     - The world is full of people
  2243.                          looking for spectacular happiness while they snub
  2244.                          contentment.
  2245.           ... Tom
  2246.  
  2247.                                   Credits
  2248.                               ----------------
  2249.  
  2250. THIS TOOLBOX WOOD NOT HAVE BEEN POSSIBLE WITHOUT Tom Murphy's continuous
  2251. creation of more mechanism to generate and serve the Toolbox evermore
  2252. efficaciously, Rob "barefoot gaud" Toy's steadfast support in updating swank
  2253. to IRIX 6.2 as well as keeping it going through all sorts of "system
  2254. vagaries", Marc Romankewicz's unconditional support in helping to burn the
  2255. series of trial as well as final CD WORM masters, Sophie Lonsky, and Amy
  2256. Gregg's indefatigable focused direction and talents to manifest production
  2257. of this CD;
  2258. EXTRA SPECIAL THANX ALSO GOES TO Donna Yobs, Carsten Koch, Chris Pirazzi,
  2259. Michael Portuesi, Nelson Bolyard, Grant Dorman, Michele Chambers-Turner,
  2260. Greg Poist, Micheal Minakami, Allen Akin, Kimi Bishop, Patrick Bouchaud,
  2261. Ariel Faigon, Robert Tray, Kent Sandvik, Keith Cok, Dave Bouvier Kris Solem,
  2262. Dave Olson, Todd Kulick, Dave Frederick, Greg Ferguson, Robert Skinner,
  2263. Anatole Gordon, Rick McLeod, Dave McAllister, Michael Stebbins, Ravi
  2264. Shankar, Jim Truher, Jeff McDonald, Caroline Lowry, Pete Sullivan, John
  2265. Schimpf, Jessica Hardwick, Calvin Chinn, Grant Gouldon, Ben Mahjoor, Victor
  2266. Riley, Lance Welsh, Sam Leffler, Tom Benoist, Mike Gold, David Marsland,
  2267. Mark Kilgard, Gretchen Helms, Arsenio Briones, Bill Henderson, Shabbir
  2268. Latif, Matt Johnson, Judy Xavier, Beejay Murphy, Kathy Roy, Scott Henry,
  2269. Susan Lewis, Peter Hecke, Joe Ushana, Boe Gatiss, Bob Miller, Andy Cameron,
  2270. Mike Sweet, Roger Chickering, Kathy Simpson, Jim Helman, Doug Young, Rod
  2271. Armer, Callum Eastwood, Rhonda Rowland, Scott Takaoka, Ken Kershner, Bob
  2272. Green, Art Gary, Phil Culver, Ken Trant, Louis Crumpler, Matt Williams,
  2273. Aaron Schuman, Roger Brown, David Watson, Terry Drasny, Ann LaGrone, and Eva
  2274. Manolis
  2275.                    --------------------------------------
  2276.  
  2277.      For all issues relative to the content of the Toolbox, pleeze contact:
  2278.         o dave "information ferret" ratcliffe: dave@sgi.com, 415/933-3556,
  2279.           fax: 415/967-6239
  2280.         o Tom "the mechanic" Murphy: murphy@sgi.com, 415/933-9134, fax:
  2281.           415/967-6239
  2282.         o or, DTjanitor@sgi.com which sends mail to both of us
  2283.           simultaneously.
  2284.  
  2285.      For all other issues relative to the Toolbox, pleeze contact:
  2286.         o devprogram@sgi.com, 415/933-3033, 1-800/770-3033, fax:
  2287.           415/969-6327.
  2288.  
  2289. ----------------------------------------------------------------------------
  2290.  
  2291. And finally a few legal attributions:
  2292.  
  2293. Copyright ⌐ 1996, Silicon Graphics, Inc. All rights reserved. Specifications
  2294. subject to change without notice. Silicon Graphics, IRIS, OpenGL, and the
  2295. Silicon Graphics logo are registered trademarks and Indigo Magic, Reality
  2296. Engine, XFS, Indigo▓ Video, Galileo Video, IRIS GL, GL, Cosmo Compress,
  2297. Sirius Video, Indy, REACT, Indy Cam, Indy Video, IRIS InSight, IRIX, Open
  2298. Inventor, and Silicon Studio are trademarks, of Silicon Graphics, Inc. MIPS
  2299. is a registered trademark of MIPS Technologies, Inc.
  2300.  
  2301. FORTRAN is a registered trademark of Information Processing Technologies
  2302. Corporation. FrameMaker is a registered trademark of Frame Technology
  2303. Corporation. MIDI City is a registered trademark of Blue Ribbon Soundworks,
  2304. Ltd. PostScript is a registered trademark of Adobe Systems, Inc. Motif is a
  2305. trademark of Open Software Foundation. Netscape is a trademark of Netscape
  2306. Communications Corporation.
  2307.